Skip to main content
GET
/
v1
/
agent
/
{id}
/
slack
/
status
Get Slack Status
curl --request GET \
  --url https://api.app.shinzo.ai/v1/agent/{id}/slack/status \
  --header 'Authorization: Bearer <token>'
{
  "linked": true,
  "slack_user_id": "<string>",
  "slack_team_id": "<string>",
  "slack_username": "<string>",
  "linked_at": "<string>",
  "channel_binding_id": "<string>"
}

​
Authentication

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

​
Example Request

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

​
Example Response

​
Linked Account

{
  "linked": true,
  "slack_user_id": "U01234ABCDE",
  "slack_team_id": "T01234ABCDE",
  "slack_username": "john_doe",
  "linked_at": "2026-02-20T10:30:00Z",
  "channel_binding_id": "cb-123e4567-e89b-12d3-a456-426614174000"
}

​
Not Linked

{
  "linked": false
}

​
Response Fields

​
linked
boolean
required
Whether a Slack account is currently linked to the agent
​
slack_user_id
string
Slack user ID (only present if linked)
​
slack_team_id
string
Slack workspace/team ID (only present if linked)
​
slack_username
string
Slack username (only present if linked)
​
linked_at
string
ISO 8601 timestamp of when the account was linked (only present if linked)
​
channel_binding_id
string
UUID of the channel binding record (only present if linked)

​
Status Codes

CodeDescription
200Status retrieved successfully
401Unauthorized - invalid or missing authentication
404Agent not found