Skip to main content
Salfio Docs

Search documentation

Type to search this documentation.

On this pageOverview

List a Slack integration's channels

Returns the channels the workspace bot is a member of for a Slack integration — the valid set of channel names to pass in the `slackChannels` shorthand when creating an assignment rule. Only Slack integrations have channels: any other integration type returns `400 invalid_argument`. The integration must be active — a disconnected, expired, or disabled one returns `409 conflict`. Cross-tenant or unknown integration IDs return `404 not_found` with no existence leak.

GET

/integrations/{integrationId}/channels

bearerAuth``

AuthorizationBearer <token>

Salfio API tokens start with the literal prefix sk_live_ followed by 32 base62 characters (≈190 bits of entropy). Tokens are hashed at rest with argon2id and shown to the user only once at creation.

In: header

integrationId*string

Integration UUID (must be a Slack integration).

Formatuuid

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.salfio.com/v1/integrations/497f6eca-6276-4993-bfeb-53cbbbba6f08/channels"

{
  "meta": {
    "cursor": "string",
    "hasMore": true
  },
  "data": [
    {
      "id": "C0123ABCD",
      "name": "general",
      "isPrivate": true,
      "isExtShared": true,
      "memberCount": 0
    }
  ]
}

{
  "error": {
    "code": "invalid_argument",
    "message": "limit must be an integer between 1 and 100"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Authentication required"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "client not found"
  }
}

{
  "error": {
    "code": "conflict",
    "message": "client is already deleted"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded",
    "details": {
      "retry_after_seconds": 30
    }
  }
}
Export
Suggest an edit to this page

Documentation menu