> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heyhumm.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Integration Sources

> List all integration sources accessible to the user.



## OpenAPI

````yaml https://config.heyhumm.ai/api/openapi.json get /api/integration-sources
openapi: 3.1.0
info:
  title: Configuration API
  description: >-
    API for managing configuration and queues for various services. This service
    consolidates the API functionality previously provided by dd_rag_api and
    code_rag_api.
  version: 1.0.0
servers:
  - url: https://config.heyhumm.ai
security: []
paths:
  /api/integration-sources:
    get:
      tags:
        - Integration Sources
      summary: List Integration Sources
      description: List all integration sources accessible to the user.
      operationId: list_integration_sources_api_integration_sources_get
      parameters:
        - name: organization_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            title: Organization Id
        - name: source_type
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/SourceType'
              - type: 'null'
            title: Source Type
        - name: connector_type
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Connector Type
        - name: is_active
          in: query
          required: false
          schema:
            anyOf:
              - type: boolean
              - type: 'null'
            title: Is Active
        - name: include_system
          in: query
          required: false
          schema:
            type: boolean
            default: false
            title: Include System
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/IntegrationSourceResponse'
                title: Response List Integration Sources Api Integration Sources Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    SourceType:
      type: string
      enum:
        - database
        - saas
      title: SourceType
      description: Types of integration sources supported.
    IntegrationSourceResponse:
      properties:
        name:
          type: string
          title: Name
          description: Display name for the integration source
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: Optional description for the integration source
        source_type:
          $ref: '#/components/schemas/SourceType'
          description: Type of source (database or saas)
        is_system:
          type: boolean
          title: Is System
          description: Whether this is a system-managed source (e.g., Athena backing store)
          default: false
        is_sync:
          type: boolean
          title: Is Sync
          description: Whether this is an Airbyte-backed sync connector
          default: false
        connector_type:
          type: string
          title: Connector Type
          description: Specific connector type (e.g., postgresql, mysql, hubspot)
        organization_id:
          type: string
          format: uuid
          title: Organization Id
          description: Organization that owns this integration source
        configuration:
          additionalProperties: true
          type: object
          title: Configuration
          description: Non-sensitive configuration data
        capabilities:
          items:
            type: string
          type: array
          title: Capabilities
          description: List of capabilities supported by this source
        is_active:
          type: boolean
          title: Is Active
          description: Whether this integration source is active
          default: true
        connection_status:
          $ref: '#/components/schemas/ConnectionStatus'
          description: Current connection status
          default: unknown
        last_connection_test:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Last Connection Test
          description: Timestamp of last connection test
        legacy_data_source_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Legacy Data Source Id
          description: >-
            ID of the legacy data source this integration source was migrated
            from
        system_source_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: System Source Id
          description: >-
            ID of the backing system source (e.g., Athena) for introspection
            routing
        instance_label:
          anyOf:
            - type: string
              maxLength: 20
            - type: 'null'
          title: Instance Label
          description: >-
            Short label for tool name disambiguation (e.g., 'US', 'CA'). Forced
            uppercase. Required when multiple instances of the same connector
            type exist.
        airbyte_source_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Airbyte Source Id
          description: Airbyte Cloud source ID
        airbyte_connection_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Airbyte Connection Id
          description: Airbyte Cloud connection ID
        airbyte_connection_ids:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Airbyte Connection Ids
          description: Airbyte Cloud connection IDs (one per stream group)
        airbyte_destination_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Airbyte Destination Id
          description: Org-specific Airbyte destination ID
        last_sync_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Last Sync At
          description: Last successful Airbyte sync time
        last_sync_status:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Sync Status
          description: >-
            Airbyte sync status: success, failed, running, auth_required,
            configuring
        last_sync_row_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Last Sync Row Count
          description: Rows synced in last Airbyte job
        selected_streams:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Selected Streams
          description: >-
            User-selected stream names to sync. None = sync all (backward
            compat).
        description_source:
          anyOf:
            - type: string
              enum:
                - ai_generated
                - manual_edit
                - imported
                - information_schema
            - type: 'null'
          title: Description Source
          description: >-
            How description was created: 'ai_generated' | 'manual_edit' |
            'imported' | 'information_schema'
        description_generated_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Description Generated At
          description: When description was last modified
        id:
          type: string
          format: uuid
          title: Id
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
        description_version:
          type: integer
          title: Description Version
      type: object
      required:
        - name
        - source_type
        - connector_type
        - organization_id
        - id
        - created_at
        - updated_at
        - description_version
      title: IntegrationSourceResponse
      description: Response model for integration sources (excludes sensitive data).
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ConnectionStatus:
      type: string
      enum:
        - connected
        - disconnected
        - error
        - unknown
      title: ConnectionStatus
      description: Status of the integration source connection.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````