Skip to main content
GET
/
v1
/
agent
/
{id}
/
channels
List Channel Bindings
curl --request GET \
  --url https://api.app.shinzo.ai/v1/agent/{id}/channels \
  --header 'Authorization: Bearer <token>'

​
Authentication

Requires JWT token or Platform API key via Authorization: Bearer <token> header.
​
id
string
required
Agent UUID

​
Example Request

curl -X GET https://api.app.shinzo.ai/v1/agent/a1b2c3d4-e5f6-7890-abcd-ef1234567890/channels \
  -H "Authorization: Bearer <token>"

​
Example Response

{
  "bindings": [
    {
      "id": "bind_abc123",
      "channel": "api",
      "status": "active",
      "created_at": "2025-01-15T10:00:00Z"
    },
    {
      "id": "bind_def456",
      "channel": "discord",
      "status": "active",
      "discord_user_id": "123456789012345678",
      "discord_username": "myuser#1234",
      "created_at": "2025-01-16T12:00:00Z"
    },
    {
      "id": "bind_ghi789",
      "channel": "slack",
      "status": "active",
      "slack_user_id": "U01234ABCDE",
      "slack_username": "john.doe",
      "created_at": "2025-01-17T14:30:00Z"
    },
    {
      "id": "bind_jkl012",
      "channel": "telegram",
      "status": "active",
      "telegram_user_id": "123456789",
      "telegram_username": "johndoe",
      "created_at": "2025-01-18T09:15:00Z"
    }
  ]
}

​
Status Codes

CodeDescription
200Success
401Unauthorized - invalid or missing authentication
404Agent not found