channels

Revoke a WhatsApp connect link

Kill a link you have sent: wrong address, forwarded, or simply no longer wanted.

The customer holding a revoked link is told it was cancelled, not that it is invalid. That is a more useful answer, and the row is kept so you can still see the link existed.

A link that has ALREADY been used cannot be revoked: 409 resource_in_use. Revoking it would imply the connection it created had been undone, and it has not. Undoing that means disconnecting the channel instead.

Revoking an already-revoked link succeeds. You wanted it dead; it is dead.

An id from another workspace returns 404 rather than confirming it exists.

delete/api/v1/channels/connect-sessions/{id}

Request

  • Base URL: https://app.blueticked.com
  • URL: https://app.blueticked.com/api/v1/channels/connect-sessions/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

The resource's unique identifier.

Response

Success

idstring uuid required
statusstring required
request_idstring required

Example response

{
  "id": "55da18e2-8acb-46cb-9d58-1bc94a287783",
  "status": "revoked",
  "request_id": "req_b2e3d610e10f1b07468721ee98f0e1d2"
}

Changes

No recorded changes to this operation across all 1 revision of this API.