> ## Documentation Index > Fetch the complete documentation index at: https://docs.labelbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Get the connected Slack bot's bounded channel-selection catalog > Returns a channel-selection snapshot of at most 1,000 memberships from the connected Slack workspace, using that installation's credential, so an automation trigger can be configured by picking a channel instead of pasting its id. Only a Slack connection has channels; the list is scoped to the connection's own workspace. A channel the bot is not a member of is never listed: invite the bot in Slack first. Throttled reads return 429 slack_rate_limited. A list that stopped at the size budget says truncated=true, so absence from the list never proves the bot is not a member. If the Slack app lacks channels:read or groups:read the response is 422 slack_missing_scope naming the scopes to add. ## OpenAPI ````yaml /recursion/openapi.yaml get /managed-agents/v1/integrations/connections/{connectionId}/channel-catalog openapi: 3.1.0 info: title: Managed Agents API version: 0.14.0 description: >- The Recursion Managed Agents REST API. Authenticate with a Recursion API key as a bearer token. An organization-scoped key acts in its own organization and needs nothing else; a tenant-scoped key must also send `x-organization-id` with an organization id or `default`. Field names follow each operation's published schema. servers: - url: https://api.recursion.labelbox.com security: - bearerAuth: [] paths: /managed-agents/v1/integrations/connections/{connectionId}/channel-catalog: get: tags: - Integrations summary: Get the connected Slack bot's bounded channel-selection catalog description: >- Returns a channel-selection snapshot of at most 1,000 memberships from the connected Slack workspace, using that installation's credential, so an automation trigger can be configured by picking a channel instead of pasting its id. Only a Slack connection has channels; the list is scoped to the connection's own workspace. A channel the bot is not a member of is never listed: invite the bot in Slack first. Throttled reads return 429 slack_rate_limited. A list that stopped at the size budget says truncated=true, so absence from the list never proves the bot is not a member. If the Slack app lacks channels:read or groups:read the response is 422 slack_missing_scope naming the scopes to add. operationId: managedAgentsGetIntegrationSlackChannelCatalog parameters: - description: Slack integration connection identifier. in: path name: connectionId required: true schema: description: Slack integration connection identifier. format: uuid type: string - $ref: '#/components/parameters/RecursionTenantId' - $ref: '#/components/parameters/RecursionOrganizationId' responses: '200': content: application/json: schema: $ref: '#/components/schemas/SlackChannels' description: >- The channels a Slack connection's bot is a member of, read live from Slack with a short cache. Returned to populate the channel picker when creating or editing a Slack trigger binding; the binding itself still stores the channel id. headers: recursion-organization-id: $ref: '#/components/headers/RecursionOrganizationId' recursion-tenant-id: $ref: '#/components/headers/RecursionTenantId' '400': description: Bad Request. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiErrorInvalidRequest' x-recursion-error-codes: - invalid_request headers: recursion-organization-id: $ref: '#/components/headers/RecursionOrganizationId' recursion-tenant-id: $ref: '#/components/headers/RecursionTenantId' '401': description: Unauthorized. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiErrorUnauthorized' x-recursion-error-codes: - unauthorized headers: recursion-organization-id: $ref: '#/components/headers/RecursionOrganizationId' recursion-tenant-id: $ref: '#/components/headers/RecursionTenantId' '403': description: Forbidden. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiErrorForbidden' x-recursion-error-codes: - forbidden headers: recursion-organization-id: $ref: '#/components/headers/RecursionOrganizationId' recursion-tenant-id: $ref: '#/components/headers/RecursionTenantId' '404': description: Not Found. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiErrorNotFound' x-recursion-error-codes: - not_found headers: recursion-organization-id: $ref: '#/components/headers/RecursionOrganizationId' recursion-tenant-id: $ref: '#/components/headers/RecursionTenantId' '413': description: Payload Too Large. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiErrorPayloadTooLarge' x-recursion-error-codes: - payload_too_large headers: recursion-organization-id: $ref: '#/components/headers/RecursionOrganizationId' recursion-tenant-id: $ref: '#/components/headers/RecursionTenantId' '422': description: Unprocessable Entity. content: application/json: schema: oneOf: - $ref: >- #/components/schemas/ManagedAgentsApiErrorSlackChannelsRejected - $ref: >- #/components/schemas/ManagedAgentsApiErrorSlackConnectionMalformed - $ref: >- #/components/schemas/ManagedAgentsApiErrorSlackInstallationMismatch - $ref: >- #/components/schemas/ManagedAgentsApiErrorSlackMissingScope - $ref: >- #/components/schemas/ManagedAgentsApiErrorSlackReapprovalRequired discriminator: propertyName: code mapping: slack_channels_rejected: >- #/components/schemas/ManagedAgentsApiErrorSlackChannelsRejected slack_connection_malformed: >- #/components/schemas/ManagedAgentsApiErrorSlackConnectionMalformed slack_installation_mismatch: >- #/components/schemas/ManagedAgentsApiErrorSlackInstallationMismatch slack_missing_scope: >- #/components/schemas/ManagedAgentsApiErrorSlackMissingScope slack_reapproval_required: >- #/components/schemas/ManagedAgentsApiErrorSlackReapprovalRequired x-recursion-error-codes: - slack_channels_rejected - slack_connection_malformed - slack_installation_mismatch - slack_missing_scope - slack_reapproval_required headers: recursion-organization-id: $ref: '#/components/headers/RecursionOrganizationId' recursion-tenant-id: $ref: '#/components/headers/RecursionTenantId' '429': headers: Retry-After: description: >- When present, delay in seconds or an HTTP-date after which the caller may retry; absence supplies no retry advice. schema: type: string style: simple recursion-organization-id: $ref: '#/components/headers/RecursionOrganizationId' recursion-tenant-id: $ref: '#/components/headers/RecursionTenantId' description: Too Many Requests. content: application/json: schema: oneOf: - $ref: >- #/components/schemas/ManagedAgentsApiErrorRateLimitExceeded - $ref: '#/components/schemas/ManagedAgentsApiErrorSlackRateLimited' discriminator: propertyName: code mapping: rate_limit_exceeded: >- #/components/schemas/ManagedAgentsApiErrorRateLimitExceeded slack_rate_limited: '#/components/schemas/ManagedAgentsApiErrorSlackRateLimited' x-recursion-error-codes: - rate_limit_exceeded - slack_rate_limited '500': description: Internal Server Error. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiErrorInternalError' x-recursion-error-codes: - internal_error headers: recursion-organization-id: $ref: '#/components/headers/RecursionOrganizationId' recursion-tenant-id: $ref: '#/components/headers/RecursionTenantId' '502': description: A dependent service returned an invalid response. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiErrorDependencyFailure' x-recursion-error-codes: - bad_gateway headers: recursion-organization-id: $ref: '#/components/headers/RecursionOrganizationId' recursion-tenant-id: $ref: '#/components/headers/RecursionTenantId' '503': description: Service Unavailable. content: application/json: schema: oneOf: - $ref: >- #/components/schemas/ManagedAgentsApiErrorManagedAgentsUnavailable - $ref: >- #/components/schemas/ManagedAgentsApiErrorServiceUnavailable - $ref: >- #/components/schemas/ManagedAgentsApiErrorSlackChannelsUnavailable - $ref: >- #/components/schemas/ManagedAgentsApiErrorSlackChannelsUnconfigured discriminator: propertyName: code mapping: managed_agents_unavailable: >- #/components/schemas/ManagedAgentsApiErrorManagedAgentsUnavailable service_unavailable: >- #/components/schemas/ManagedAgentsApiErrorServiceUnavailable slack_channels_unavailable: >- #/components/schemas/ManagedAgentsApiErrorSlackChannelsUnavailable slack_channels_unconfigured: >- #/components/schemas/ManagedAgentsApiErrorSlackChannelsUnconfigured x-recursion-error-codes: - managed_agents_unavailable - service_unavailable - slack_channels_unavailable - slack_channels_unconfigured headers: recursion-organization-id: $ref: '#/components/headers/RecursionOrganizationId' recursion-tenant-id: $ref: '#/components/headers/RecursionTenantId' '504': headers: Retry-After: description: When to retry, as delay seconds or an HTTP date. schema: type: string recursion-organization-id: $ref: '#/components/headers/RecursionOrganizationId' recursion-tenant-id: $ref: '#/components/headers/RecursionTenantId' description: A dependent service timed out. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiErrorDependencyTimeout' x-recursion-error-codes: - gateway_timeout components: parameters: RecursionTenantId: name: x-tenant-id in: header required: false description: >- Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is `default`. schema: type: string minLength: 1 RecursionOrganizationId: name: x-organization-id in: header required: false description: >- Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or `default`. schema: type: string minLength: 1 schemas: SlackChannels: description: >- The channels a Slack connection's bot is a member of, read live from Slack with a short cache. Returned to populate the channel picker when creating or editing a Slack trigger binding; the binding itself still stores the channel id. properties: channels: description: >- Bounded channel-selection catalog, sorted by name. A channel the bot has not been invited to is never listed; invite it in Slack first. Check truncated before treating absence as meaningful. items: $ref: '#/components/schemas/SlackChannel' maxItems: 1000 type: array fetchedAt: description: >- When this list was read from Slack (RFC 3339). Lists are cached briefly, so a channel joined a moment ago may not appear yet. format: date-time type: string retryAfterSeconds: description: >- How long to wait before asking again, when the list is stale because Slack throttled the read. type: integer minimum: -9007199254740991 maximum: 9007199254740991 stale: description: >- True when Slack could not be asked and an expired cached list was served instead. Check retryAfterSeconds before retrying. type: boolean truncated: description: >- True when the listing stopped at a size budget while Slack still had more channels; channels past the budget are absent, so a missing channel does not mean the bot is not a member. type: boolean required: - channels - fetchedAt - stale - truncated type: object additionalProperties: false ManagedAgentsApiErrorInvalidRequest: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - invalid_request message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorUnauthorized: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - unauthorized message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorForbidden: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - forbidden message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorNotFound: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - not_found message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorPayloadTooLarge: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - payload_too_large message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorSlackChannelsRejected: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - slack_channels_rejected message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorSlackConnectionMalformed: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - slack_connection_malformed message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorSlackInstallationMismatch: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - slack_installation_mismatch message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorSlackMissingScope: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - slack_missing_scope message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorSlackReapprovalRequired: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - slack_reapproval_required message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorRateLimitExceeded: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - rate_limit_exceeded message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorSlackRateLimited: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - slack_rate_limited message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorInternalError: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - internal_error message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorDependencyFailure: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - bad_gateway message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorManagedAgentsUnavailable: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - managed_agents_unavailable message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorServiceUnavailable: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - service_unavailable message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorSlackChannelsUnavailable: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - slack_channels_unavailable message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorSlackChannelsUnconfigured: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - slack_channels_unconfigured message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorDependencyTimeout: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - gateway_timeout message: type: string minLength: 1 description: Human-readable error message. details: $ref: '#/components/schemas/ManagedAgentsApiErrorDetails' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. required: - code - message additionalProperties: false description: Standard flat error response. SlackChannel: description: >- One channel the Slack connection's bot is a member of: the id a binding stores, the name the workspace shows, and whether it is private or shared with another organization. properties: id: description: Slack channel id, the value a trigger binding stores as channel_id. type: string isExtShared: description: >- Whether the channel is shared with another organization (Slack Connect). A proactive binding here lets external members start investigations. type: boolean isPrivate: description: Whether the channel is private in the connected workspace. type: boolean name: description: >- Channel name as the connected workspace sees it, without the leading #. Slack Connect channels can carry a different name in the other workspace. type: string required: - id - name - isPrivate - isExtShared type: object additionalProperties: false ManagedAgentsApiErrorDetails: type: object properties: field: description: >- Request field or header responsible for the error, when one can be identified. type: string issues: description: >- Boundary-validation failures as path-prefixed human-readable messages. type: array items: type: string requestId: description: Request correlation identifier for support and log lookup. type: string retryable: description: >- Server advice about failure transience. `true` means transient, `false` means non-transient, and absence gives no advice. Automatic replay is allowed only when this field is not `false` and the operation-specific retry and idempotency contract permits replay. type: boolean additionalProperties: $ref: '#/components/schemas/PlatformSafeJsonValue' description: >- Optional structured error details. Reserved transport fields are typed; code-specific fields remain forward compatible. PlatformSafeJsonValue: description: >- A JSON value whose integer members stay within the exact ECMAScript safe-integer range at every nesting level. oneOf: - type: 'null' - type: boolean - type: string - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: number not: type: integer - type: array items: $ref: '#/components/schemas/PlatformSafeJsonValue' - additionalProperties: $ref: '#/components/schemas/PlatformSafeJsonValue' type: object headers: RecursionOrganizationId: description: Organization id resolved for this request. schema: type: string minLength: 1 RecursionTenantId: description: Tenant id resolved for this request. schema: type: string minLength: 1 securitySchemes: bearerAuth: type: http scheme: bearer description: A Recursion API key, created in the console under API keys. ````