Revoke conversation stream tokens

Request

Realtime streaming of conversation events uses Server-Sent Events (SSE). It is an opt-in feature, enabled per workspace. Contact Intercom to turn it on.

Revoke every active conversation stream token for a contact. Call this when the contact signs out or you suspect a token has been exposed.

Requires the read_conversations permission.

Security

bearerAuth

Query

external_idstringrequired

The external ID of the contact whose tokens to revoke.

Example:external_id=contact-1234

Intercom-Versionstring(intercom_version)

Intercom API version.
By default, it's equal to the version set in the app package.

Default:"2.16"

Enum:"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4"

Example:2.16

curl -i -X DELETE \
  'https://api.intercom.io/conversations/stream/token?external_id=contact-1234' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Intercom-Version: 2.16'

Responses

Tokens revoked

Response

No content