Skip to main content
DELETE /api/v1/forward/channels/{channel_id} Deletes a Channel that is no longer needed.

Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT>

Path parameters

ParameterTypeRequiredDescription
channel_idstringYesChannel ID. Same value as the Channel object’s id.

Example request

curl -s -X DELETE 'https://api.qoder.com/api/v1/forward/channels/channel_019eabc123' \
  -H "Authorization: Bearer $QODER_PAT"

Example response

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

Response fields

FieldTypeDescription
idstringDeleted Channel ID.
deletedbooleanWhether deletion succeeded. Always true on success.

Deletion rules

  • After deletion, the Channel no longer processes inbound messages, cannot continue QR binding, and cannot send channel replies.
  • Deletion is irreversible. To pause inbound processing temporarily, use Update Channel with enabled=false.

Errors

HTTPTypeCodeTrigger
401authentication_error-PAT is invalid, expired, or missing.
404not_found_error-Channel does not exist or is not visible to the caller.
502api_error-Channel deletion failed.

Get a channel

Update a channel