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

# Update Integration Source

> Update an integration source.



## OpenAPI

````yaml https://config.heyhumm.ai/api/openapi.json put /api/integration-sources/{source_id}
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/{source_id}:
    put:
      tags:
        - Integration Sources
      summary: Update Integration Source
      description: Update an integration source.
      operationId: update_integration_source_api_integration_sources__source_id__put
      parameters:
        - name: source_id
          in: path
          required: true
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            title: Source Id
        - name: organization_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            title: Organization Id
        - name: resource_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            title: Resource Id
        - name: integration_source_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            title: Integration Source Id
        - name: data_source_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            title: Data Source Id
        - name: context_source_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            title: Context Source Id
        - name: job_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            title: Job Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IntegrationSourceUpdate'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IntegrationSourceResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    IntegrationSourceUpdate:
      properties:
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        configuration:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Configuration
        capabilities:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Capabilities
        is_active:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Active
        connection_status:
          anyOf:
            - $ref: '#/components/schemas/ConnectionStatus'
            - type: 'null'
        last_connection_test:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Last Connection Test
        legacy_data_source_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Legacy Data Source Id
        system_source_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: System Source Id
        instance_label:
          anyOf:
            - type: string
            - type: 'null'
          title: Instance Label
        airbyte_source_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Airbyte Source Id
        airbyte_connection_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Airbyte Connection Id
        airbyte_connection_ids:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Airbyte Connection Ids
        airbyte_destination_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Airbyte Destination Id
        last_sync_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Last Sync At
        last_sync_status:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Sync Status
        last_sync_row_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Last Sync Row Count
        selected_streams:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Selected Streams
        description_source:
          anyOf:
            - type: string
              enum:
                - ai_generated
                - manual_edit
                - imported
                - information_schema
            - type: 'null'
          title: Description Source
        description_generated_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Description Generated At
        description_version:
          anyOf:
            - type: integer
            - type: 'null'
          title: Description Version
      type: object
      title: IntegrationSourceUpdate
      description: Model for updating an integration source.
    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.
    SourceType:
      type: string
      enum:
        - database
        - saas
      title: SourceType
      description: Types of integration sources supported.
    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

````