Channels

List channels

List channels. Authenticate with a bearer API key that includes the required scope. Resources that belong to another account return 404 NOT_FOUND. Mutations accept Idempotency-Key and emit a webhook event when they succeed.

Required scopechannels:read

curl -X GET https://api.agentency.com/v1/chatbots/{chatbotId}/channels \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"

Retrieve a channel

Retrieve a channel. Authenticate with a bearer API key that includes the required scope. Resources that belong to another account return 404 NOT_FOUND. Mutations accept Idempotency-Key and emit a webhook event when they succeed.

Required scopechannels:read

curl -X GET https://api.agentency.com/v1/chatbots/{chatbotId}/channels/{platform} \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"

Connect channel

Connect channel. Authenticate with a bearer API key that includes the required scope. Resources that belong to another account return 404 NOT_FOUND. Mutations accept Idempotency-Key and emit a webhook event when they succeed.

Required scopechannels:write

curl -X POST https://api.agentency.com/v1/chatbots/{chatbotId}/channels/{platform} \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"

Disconnect channel

Disconnect channel. Authenticate with a bearer API key that includes the required scope. Resources that belong to another account return 404 NOT_FOUND. Mutations accept Idempotency-Key and emit a webhook event when they succeed.

Required scopechannels:write

curl -X DELETE https://api.agentency.com/v1/chatbots/{chatbotId}/channels/{platform} \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"

Verify channel

Verify channel. Authenticate with a bearer API key that includes the required scope. Resources that belong to another account return 404 NOT_FOUND. Mutations accept Idempotency-Key and emit a webhook event when they succeed.

Required scopechannels:write

curl -X POST https://api.agentency.com/v1/chatbots/{chatbotId}/channels/{platform}/verify \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"