Intercom API (unofficial showcase)
PUT/dynamic_contents/{id}

Update dynamic content

Updates an existing reusable dynamic content item. Provide only the fields you want to change; if you send variations, that array replaces the full set and any omitted existing variations are deleted. The authenticated user needs the read_write_dynamic_content scope.

2 parameters · 3 body fields
idstringrequired
The unique identifier of the dynamic content to update.
Intercom-Versionstringoptional
The Intercom API version to use. Defaults to `2.17` when omitted.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

Partial dynamic content update. All fields are optional; only supplied fields are changed. Supplying variations replaces the full set of existing variations.

namestringoptional
The name of the dynamic content. Must be unique in the workspace. Renaming doesn't change the `key`.
default_localestringoptional
The locale whose variation is used when there's no variation for the requested locale. The dynamic content must have a variation for this locale that applies to all brands.
variationsarray<DynamicContentVariationRequest>optional
The full set of variations. Existing variations that aren't included are deleted.

5 status codes
200Returns the updated dynamic content object, including its identifier, name, key, content type, default locale, variations, and creation and update timestamps.
typestringoptional
String representing the object's type. Always has the value `dynamic_content`.
idstringoptional
The unique identifier for the dynamic content.
namestringoptional
The name of the dynamic content.
keystringoptional
The identifier that articles use to reference the dynamic content. Derived from the name when the dynamic content is created, and never changes.
content_typestringoptional
Whether the dynamic content is a short inline value (`inline`) or one or more blocks of content (`block`).
Allowed:inlineblock
default_localestringoptional
The locale whose variation is used when there's no variation for the requested locale.
variationsarray<DynamicContentVariation>optional
The variations of the dynamic content.
created_atintegeroptional
The time the dynamic content was created as a Unix timestamp.
updated_atintegeroptional
The time the dynamic content was last updated as a Unix timestamp.
401Returned when the request is unauthorized.

One documented failure

  • unauthorized

    Access Token Invalid

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
403Returned when dynamic content is not enabled.

One documented failure

  • api_plan_restricted

    Dynamic content is not enabled for this workspace

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
404Returned when the requested dynamic content is not found.

One documented failure

  • not_found

    Dynamic content not found

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
422Returned when request validation fails.

One documented failure

  • validation_error

    content_type is immutable after creation

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects

Error handling

A 401 is returned when authentication fails, a 403 when dynamic content is not enabled, a 404 when the dynamic content is not found, and a 422 when request validation fails. The id path parameter must identify the dynamic content to update. name cannot exceed 255 characters; if provided, variations must contain at least one item, and each item must include locale; the authenticated user needs the read_write_dynamic_content scope.