Skip to main content
Channels

Unpair a channel

Remove the pairing between a Channel conversation scope and its Identity.

DELETE /api/v1/forward/channel_pairings/{pairing_id}

Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT or SAT>

Path parameters

ParameterTypeRequiredDescription
pairing_idstringYesThe id returned by List channel pairings, Get a channel pairing, or Pair a channel.

Example request

curl -s -X DELETE 'https://api.qoder.com.cn/api/v1/forward/channel_pairings/pair_019eabc123' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

Example response

HTTP 200 OK
{
  "id": "pair_019eabc123",
  "deleted": true
}

Response fields

FieldTypeDescription
idstringPairing ID.
deletedbooleantrue when successfully unpaired.

HTTP error codes

HTTPTypeTrigger
400invalid_request_errorpairing_id is blank or contains control characters, or the Channel is found not to be in pairing mode when resolving the pairing's Channel.
401authentication_errorPAT or SAT is invalid or expired.
403permission_errorThe caller does not have permission to invoke the API.
404not_found_errorWhen resolving the pairing's Channel, that Channel does not exist, is archived, or is inaccessible.
409conflict_errorThe binding was modified concurrently.

Notes

  • A nonexistent or already unpaired pairing returns 200 and deleted=true. An existing pairing must still pass access checks.
  • Unpairing invalidates the original binding. Trigger the channel pairing flow again to obtain a new pairing code.