> ## 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.

# List event sources

> Returns a bounded page of non-secret source summaries, newest first. Protocol configuration is available only on member reads.



## OpenAPI

````yaml /managed-agents/openapi.yaml get /managed-agents/v1/event-sources
openapi: 3.1.0
info:
  title: Managed Agents API
  version: 0.13.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/event-sources:
    get:
      tags:
        - Event Sources
      summary: List event sources
      description: >-
        Returns a bounded page of non-secret source summaries, newest first.
        Protocol configuration is available only on member reads.
      operationId: managedAgentsListEventSources
      parameters:
        - description: Maximum source summaries to return. Defaults to 50.
          in: query
          name: limit
          schema:
            default: 50
            description: Maximum source summaries to return. Defaults to 50.
            maximum: 100
            minimum: 1
            type: integer
        - description: >-
            Opaque cursor from nextCursor. Pass it unchanged with the same
            limit.
          in: query
          name: cursor
          schema:
            description: >-
              Opaque cursor from nextCursor. Pass it unchanged with the same
              limit.
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsEventSourcePageResponse'
          description: Bounded page of event sources owned by the calling workspace.
        '400':
          description: The request was rejected by schema or semantic validation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorInvalidRequest'
        '401':
          description: The caller is unauthenticated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorUnauthorized'
        '403':
          description: The caller lacks a required permission or capability.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorForbidden'
        '429':
          headers:
            Retry-After:
              description: Seconds the caller should wait before retrying.
              schema:
                type: string
              style: simple
          description: A rate limit is exhausted. Honor `Retry-After`.
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: >-
                      #/components/schemas/ManagedAgentsApiErrorRateLimitExceeded
                  - $ref: '#/components/schemas/ManagedAgentsApiErrorRateLimited'
                discriminator:
                  propertyName: code
                  mapping:
                    rate_limit_exceeded:
                      $ref: >-
                        #/components/schemas/ManagedAgentsApiErrorRateLimitExceeded
                    rate_limited:
                      $ref: '#/components/schemas/ManagedAgentsApiErrorRateLimited'
        '500':
          description: An unexpected server-side failure.
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/ManagedAgentsApiErrorInternalError'
                  - $ref: >-
                      #/components/schemas/ManagedAgentsApiErrorInvariantViolation
                discriminator:
                  propertyName: code
                  mapping:
                    internal_error:
                      $ref: '#/components/schemas/ManagedAgentsApiErrorInternalError'
                    invariant_violation:
                      $ref: >-
                        #/components/schemas/ManagedAgentsApiErrorInvariantViolation
        '502':
          description: The service returned an invalid response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorBadGateway'
        '503':
          headers:
            Retry-After:
              description: Seconds the caller should wait before retrying.
              schema:
                type: string
              style: simple
          description: A dependency is unavailable. Retryable.
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: >-
                      #/components/schemas/ManagedAgentsApiErrorManagedAgentsUnavailable
                  - $ref: >-
                      #/components/schemas/ManagedAgentsApiErrorServiceUnavailable
                discriminator:
                  propertyName: code
                  mapping:
                    managed_agents_unavailable:
                      $ref: >-
                        #/components/schemas/ManagedAgentsApiErrorManagedAgentsUnavailable
                    service_unavailable:
                      $ref: >-
                        #/components/schemas/ManagedAgentsApiErrorServiceUnavailable
        '504':
          headers:
            Retry-After:
              description: When to retry, as delay seconds or an HTTP date.
              schema:
                type: string
          description: The service did not respond before the timeout. Retryable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorGatewayTimeout'
components:
  schemas:
    ManagedAgentsEventSourcePageResponse:
      additionalProperties: false
      description: Bounded page of event sources owned by the calling workspace.
      properties:
        items:
          description: Event sources in newest-first order.
          items:
            $ref: '#/components/schemas/ManagedAgentsEventSourceSummary'
          type: array
        nextCursor:
          description: Opaque cursor for the next page, or null when this is the last page.
          type:
            - 'null'
            - string
        total:
          description: Total event sources visible to the caller.
          format: int64
          minimum: 0
          type: integer
      required:
        - items
        - nextCursor
        - total
      type: object
      example:
        items:
          - createdAt: '2026-02-18T09:30:00.000Z'
            delivery:
              kind: webhook
              webhookUrl: example
            displayName: example
            eventSourceId: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
            revision: 1
            status: paused
            type: slack_events_api
            updatedAt: '2026-02-18T09:30:00.000Z'
        nextCursor: example
        total: 1
    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:
          description: Optional structured error details.
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
      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:
          description: Optional structured error details.
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
      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:
          description: Optional structured error details.
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
      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:
          description: Optional structured error details.
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorRateLimited:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - rate_limited
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          description: Optional structured error details.
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
      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:
          description: Optional structured error details.
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorInvariantViolation:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - invariant_violation
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          description: Optional structured error details.
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorBadGateway:
      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:
          description: Optional structured error details.
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
      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:
          description: Optional structured error details.
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
      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:
          description: Optional structured error details.
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorGatewayTimeout:
      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:
          description: Optional structured error details.
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsEventSourceSummary:
      additionalProperties: false
      description: Compact event-source representation returned by the collection endpoint.
      properties:
        createdAt:
          description: Time the event source was created.
          format: date-time
          type: string
        delivery:
          $ref: '#/components/schemas/ManagedAgentsEventSourceDeliverySummary'
          description: Webhook endpoint or owning integration connection.
        displayName:
          description: Human-readable source name.
          type: string
        eventSourceId:
          description: Stable identifier for the event source.
          format: uuid
          type: string
        revision:
          description: Monotonic revision represented by the member ETag.
          format: int64
          minimum: 1
          type: integer
        status:
          description: Current lifecycle state.
          enum:
            - paused
            - active
          type: string
        type:
          description: Inbound provider protocol interpreted by this source.
          enum:
            - slack_events_api
            - github_webhook
            - custom_webhook
          type: string
        updatedAt:
          description: Time the event source was last changed.
          format: date-time
          type: string
      required:
        - eventSourceId
        - displayName
        - type
        - status
        - delivery
        - revision
        - createdAt
        - updatedAt
      type: object
      example:
        createdAt: '2026-02-18T09:30:00.000Z'
        delivery:
          kind: webhook
          webhookUrl: example
        displayName: example
        eventSourceId: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
        revision: 1
        status: paused
        type: slack_events_api
        updatedAt: '2026-02-18T09:30:00.000Z'
    ManagedAgentsEventSourceDeliverySummary:
      description: Delivery identity without member-only verification configuration.
      oneOf:
        - $ref: '#/components/schemas/ManagedAgentsWebhookEventSourceDeliverySummary'
        - $ref: '#/components/schemas/ManagedAgentsIntegrationEventSourceDelivery'
      type: object
      example:
        kind: webhook
        webhookUrl: example
    ManagedAgentsWebhookEventSourceDeliverySummary:
      additionalProperties: false
      description: Customer webhook delivery without verification configuration.
      properties:
        kind:
          description: Customer-configured webhook delivery.
          enum:
            - webhook
          type: string
        webhookUrl:
          description: Relative public endpoint to configure at the event provider.
          type: string
      required:
        - kind
        - webhookUrl
      type: object
      example:
        kind: webhook
        webhookUrl: example
    ManagedAgentsIntegrationEventSourceDelivery:
      additionalProperties: false
      description: >-
        Connection-managed delivery; no customer webhook or verification
        credential is required.
      properties:
        connectionId:
          description: Owning integration connection in the same workspace.
          format: uuid
          readOnly: true
          type: string
        kind:
          description: Delivery through the platform integration callback.
          enum:
            - integration
          type: string
      required:
        - kind
        - connectionId
      type: object
      example:
        connectionId: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d
        kind: integration
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: A Recursion API key, created in the console under API keys.

````