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

Delete dynamic content

Deletes a reusable dynamic content item by its unique identifier. You cannot delete dynamic content that is still used in an article, so remove its article references before attempting deletion. The authenticated user needs the read_write_dynamic_content scope.

2 parameters
idstringrequired
The unique identifier of the dynamic content to delete.
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

5 status codes
204Returns confirmation that the dynamic content was deleted; the response has no body.
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 the dynamic content is still used in an article and cannot be deleted.

One documented failure

  • validation_error

    Cannot delete 'Support phone number' because it is still used in 2 articles

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 it is still in use. The id path parameter must identify the dynamic content to delete, and the authenticated user needs the read_write_dynamic_content scope.