v1

latestOpenAPI 3.0.02026-08-04891301.4 MB

Retrieve a Slack channel binding

Returns the Slack channel binding identified by a Slack channel ID and workspace team ID pair. Use this endpoint to look up the team and agents currently bound to a specific Slack channel.

The channel path parameter is the Slack channel ID; slack_team_id identifies the Slack workspace the channel belongs to, disambiguating channels with the same ID across workspaces. Both parameters are required. Returns 404 if no binding exists for the given pair or the associated Slack integration is not visible to the caller.

get/api/v1/slack_channel_bindings/{channel}

Path parameters

channelstring required

Slack channel ID of the binding to retrieve (e.g. C01234ABCDE).

Query parameters

slack_team_idstring required

Slack workspace team ID that the channel belongs to (e.g. T01234ABCDE). Used together with channel to uniquely identify the binding.

Response

Successful response

agentsstring[]

IDs of the agents attached to this binding. Empty array when no agents are assigned.

channelstring

Slack channel ID (e.g. C01234ABCDE) that this binding targets.

customer_labelstring

Human-readable label identifying the customer, derived from the binding's embedded config. null when not set.

idstring required

Unique identifier for this Slack channel binding.

integrationstring

ID of the Slack integration that owns this binding.

is_ext_shared_cachedboolean

Cached value of Slack's is_ext_shared flag for this channel. May be stale relative to Slack's current state.

teamstring

ID of the ArchAstro team this channel is bound to.

Example response

{
  "agents": [
    "string"
  ],
  "channel": "C01234ABCDE",
  "customer_label": "string",
  "id": "string",
  "integration": "string",
  "is_ext_shared_cached": true,
  "team": "string"
}