Lightdash AiAgents API

openapi: 3.2.0
info:
  title: Lightdash AI Agents API
  version: 0.3156.1
  description: 'Open API documentation for all public Lightdash API endpoints. # Authentication Before you get started, you might need to create a Personal Access Token to authenticate via the API. You can create a token by following this guide: https://docs.lightdash.com/references/personal_tokens

    '
  license:
    name: MIT
  contact:
    name: Lightdash Support
    email: support@lightdash.com
    url: https://docs.lightdash.com/help-and-contact/contact/contact_info/
servers:
- url: /
tags:
- name: AiAgents
paths:
  /api/v1/aiAgents/documents:
    get:
      operationId: listAiAgentDocuments
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiAiAgentDocumentSummaryListResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorPayload'
      security: []
      parameters:
      - in: query
        name: projectUuid
        required: false
        schema:
          type: string
      tags:
      - AiAgents
    post:
      operationId: createAiAgentDocument
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiAiAgentDocumentResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorPayload'
      security: []
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApiCreateAiAgentDocument'
      tags:
      - AiAgents
  /api/v1/aiAgents/documents/{documentUuid}:
    delete:
      operationId: deleteAiAgentDocument
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiSuccessEmpty'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorPayload'
      security: []
      parameters:
      - in: path
        name: documentUuid
        required: true
        schema:
          type: string
      tags:
      - AiAgents
  /api/v1/aiAgents/admin/threads:
    get:
      operationId: getAllThreads
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiAiAgentAdminConversationsResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorPayload'
      description: Get all AI agent threads for admin
      summary: List AI agent threads
      security: []
      parameters:
      - in: query
        name: page
        required: false
        schema:
          format: double
          type: number
      - in: query
        name: pageSize
        required: false
        schema:
          format: double
          type: number
      - in: query
        name: projectUuids
        required: false
        schema:
          type: array
          items:
            type: string
      - in: query
        name: agentUuids
        required: false
        schema:
          type: array
          items:
            type: string
      - in: query
        name: userUuids
        required: false
        schema:
          type: array
          items:
            type: string
      - in: query
        name: createdFrom
        required: false
        schema:
          type: string
          enum:
          - slack
          - web_app
      - in: query
        name: humanScore
        required: false
        schema:
          format: double
          type: number
      - in: query
        name: dateFrom
        required: false
        schema:
          type: string
      - in: query
        name: dateTo
        required: false
        schema:
          type: string
      - in: query
        name: search
        required: false
        schema:
          type: string
      - in: query
        name: sortField
        required: false
        schema:
          $ref: '#/components/schemas/AiAgentAdminSortField'
      - in: query
        name: sortDirection
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
      tags:
      - AiAgents
  /api/v1/aiAgents/admin/agents:
    get:
      operationId: getAllAgents
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiAiAgentSummaryResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorPayload'
      description: Get all AI agents for admin
      summary: List AI agents
      security: []
      parameters: []
      tags:
      - AiAgents
  /api/v1/aiAgents/admin/review-items:
    get:
      operationId: getAiAgentReviewItems
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiAiAgentReviewItemsResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorPayload'
      description: Get AI agent classifier review items for admin
      summary: List AI agent review items
      security: []
      parameters:
      - in: query
        name: status
        required: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/AiAgentReviewItemStatus'
      tags:
      - AiAgents
  /api/v1/aiAgents/admin/review-items/{fingerprint}:
    get:
      operationId: getAiAgentReviewItem
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiAiAgentReviewItemResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorPayload'
      description: Get AI agent classifier review signals for admin debugging
      summary: List AI agent review signals
      security: []
      parameters:
      - in: path
        name: fingerprint
        required: true
        schema:
          type: string
      tags:
      - AiAgents
    patch:
      operationId: updateAiAgentReviewItemStatus
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiAiAgentReviewItemResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorPayload'
      description: Update the status of an AI agent review item (e.g. dismiss it)
      summary: Update AI agent review item status
      security: []
      parameters:
      - in: path
        name: fingerprint
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateAiAgentReviewItemStatus'
      tags:
      - AiAgents
  /api/v1/aiAgents/admin/review-items/{fingerprint}/activity:
    get:
      operationId: getAiAgentReviewItemActivity
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiAiAgentReviewItemActivityResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorPayload'
      description: Get the remediation activity feed for a review item
      summary: Get AI agent review item activity
      security: []
      parameters:
      - in: path
        name: fingerprint
        required: true
        schema:
          type: string
      tags:
      - AiAgents
  /api/v1/aiAgents/admin/review-items/{fingerprint}/pr-diff:
    get:
      operationId: getAiAgentReviewItemPrDiff
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiAiAgentReviewItemPrDiffResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorPayload'
      description: Get the file diff of the pull request linked to a review item
      summary: Get AI agent review item PR diff
      security: []
      parameters:
      - in: path
        name: fingerprint
        required: true
        schema:
          type: string
      tags:
      - AiAgents
  /api/v1/aiAgents/admin/review-items/by-preview-thread/{threadUuid}:
    get:
      operationId: getAiAgentReviewItemByPreviewThread
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiAiAgentReviewItemResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorPayload'
      description: Get the review item linked to a remediation preview work thread
      summary: Get AI agent review item by preview thread
      security: []
      parameters:
      - in: path
        name: threadUuid
        required: true
        schema:
          type: string
      tags:
      - AiAgents
  /api/v1/aiAgents/admin/review-items/{fingerprint}/writeback:
    post:
      operationId: createAiAgentReviewItemWriteback
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiAiAgentReviewItemResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorPayload'
      description: 'Open a writeback pull request for a review item (semantic-layer or

        project-context root cause)'
      summary: Create AI agent review item writeback PR
      security: []
      parameters:
      - in: path
        name: fingerprint
        required: true
        schema:
          type: string
      tags:
      - AiAgents
  /api/v1/aiAgents/admin/review-items/{fingerprint}/writeback-preview:
    get:
      operationId: getAiAgentReviewItemWritebackPreview
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiAiAgentReviewItemWritebackPreviewResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorPayload'
      description: 'Preview the file change a writeback PR would make, without opening it.

        Only project_context findings have a deterministic diff.'
      summary: Preview AI agent review item writeback diff
      security: []
      parameters:
      - in: path
        name: fingerprint
        required: true
        schema:
          type: string
      tags:
      - AiAgents
  /api/v1/aiAgents/admin/review-signals:
    get:
      operationId: getAiAgentReviewSignals
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiAiAgentReviewSignalsResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorPayload'
      security: []
      parameters: []
      tags:
      - AiAgents
  /api/v1/aiAgents/admin/settings:
    get:
      operationId: getAiOrganizationSettings
      responses:
        '200':
          description: Retrieved AI organization settings
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiAiOrganizationSettingsResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorPayload'
      description: Get AI organization settings
      summary: Get AI settings
      security: []
      parameters: []
      tags:
      - AiAgents
    patch:
      operationId: upsertAiOrganizationSettings
      responses:
        '200':
          description: Updated AI organization settings
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiUpdateAiOrganizationSettingsResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorPayload'
      description: Update AI organization settings
      summary: Update AI settings
      security: []
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateAiOrganizationSettings'
      tags:
      - AiAgents
components:
  schemas:
    Record_string.unknown_:
      properties: {}
      additionalProperties: {}
      type: object
      description: Construct a type with a set of properties K of type T
    AiAgentReviewItemDismissedReason:
      type: string
      enum:
      - not_actionable
      - expected_behavior
      - duplicate
      - low_confidence
      - other
    AiAgentReviewRemediationLiveState:
      type: string
      enum:
      - writeback
      - compiling
      - verifying
      description: 'The in-flight step of a remediation, derived from current status + which

        events exist — never stored. Renders as the single accented "live" row.'
    PullRequestProvider:
      enum:
      - github
      - gitlab
      type: string
    AiAgentTargetRef:
      anyOf:
      - $ref: '#/components/schemas/AiAgentSemanticTargetRef'
      - properties:
          agentUuid:
            type: string
          type:
            type: string
            enum:
            - agent
        required:
        - agentUuid
        - type
        type: object
      - properties:
          setting:
            $ref: '#/components/schemas/AiAgentConfigurationSetting'
          type:
            type: string
            enum:
            - agent_config
        required:
        - setting
        - type
        type: object
      - properties:
          capabilityKey:
            type: string
          type:
            type: string
            enum:
            - product_capability
        required:
        - capabilityKey
        - type
        type: object
      - properties:
          key:
            type: string
          type:
            type: string
            enum:
            - runtime
        required:
        - key
        - type
        type: object
    ComputedAiOrganizationSettings:
      properties:
        isTrial:
          type: boolean
        isCopilotEnabled:
          type: boolean
      required:
      - isTrial
      - isCopilotEnabled
      type: object
    AiAgentDocumentSummary:
      $ref: '#/components/schemas/Omit_AiAgentDocument.storageKey_'
    ApiSuccess_AiAgentReviewItemActivity_:
      properties:
        results:
          $ref: '#/components/schemas/AiAgentReviewItemActivity'
        status:
          type: string
          enum:
          - ok
      required:
      - results
      - status
      type: object
    AiAgentAdminConversationsSummary:
      properties:
        threads:
          items:
            $ref: '#/components/schemas/AiAgentAdminThreadSummary'
          type: array
      required:
      - threads
      type: object
    ApiAiAgentReviewSignalsResponse:
      $ref: '#/components/schemas/ApiSuccess_AiAgentReviewSignalSummary-Array_'
    AiAgentRecommendation:
      properties:
        targetRefs:
          items:
            $ref: '#/components/schemas/AiAgentTargetRef'
          type: array
        rationale:
          type: string
        title:
          type: string
        actionType:
          $ref: '#/components/schemas/AiAgentRecommendationAction'
      required:
      - targetRefs
      - rationale
      - title
      - actionType
      type: object
    AiAgentReviewItemStatus:
      type: string
      enum:
      - open
      - in_progress
      - resolved
      - dismissed
      - duplicate
    ThreadSummary:
      $ref: '#/components/schemas/Pick_AiAgentThreadSummary_AiAgentUser-and-_slackUserId-string-or-null--email-string-or-null__.user-or-createdAt-or-createdFrom-or-title-or-uuid_'
    AiAgentJudgeProjectContextEntry:
      properties:
        objects:
          items:
            type: string
          type: array
        terms:
          items:
            type: string
          type: array
        content:
          type: string
        kind:
          type: string
          enum:
          - definition
          - context
        id:
          type:
          - string
          - 'null'
        op:
          type: string
          enum:
          - create
          - update
      required:
      - objects
      - terms
      - content
      - kind
      - id
      - op
      type: object
    AnyType:
      description: 'This AnyType is an alias for any

        The goal is to make it easier to identify any type in the codebase

        without having to eslint-disable all the time

        These are only used on legacy `any` types, don''t use it for new types.

        This is added on a separate file to avoid circular dependencies.'
    AiAgentReviewItemWritebackStrategy:
      type: string
      enum:
      - semantic_layer
      - project_context
    AiAgentReviewItemPrDiff:
      properties:
        truncated:
          type: boolean
        totalDeletions:
          type: number
          format: double
        totalAdditions:
          type: number
          format: double
        files:
          items:
            $ref: '#/components/schemas/AiAgentReviewItemPrDiffFile'
          type: array
        prUrl:
          type: string
      required:
      - truncated
      - totalDeletions
      - totalAdditions
      - files
      - prUrl
      type: object
    ApiSuccess_AiOrganizationSettings_:
      properties:
        results:
          $ref: '#/components/schemas/AiOrganizationSettings'
        status:
          type: string
          enum:
          - ok
      required:
      - results
      - status
      type: object
    AiAgentReviewItemOwnerType:
      type: string
      enum:
      - semantic_layer_owner
      - agent_admin
      - product
      - support
      - unknown
    AiAgentRecommendationAction:
      type: string
      enum:
      - update_semantic_yaml
      - update_agent_instructions
      - add_knowledge_document
      - enable_data_access
      - enable_sql_mode
      - enable_self_improvement
      - configure_mcp_server
      - adjust_explore_tags
      - update_access
      - route_to_product_work
      - request_more_evidence
      - no_action
    KnexPaginateArgs:
      properties:
        page:
          type: number
          format: double
        pageSize:
          type: number
          format: double
      required:
      - page
      - pageSize
      type: object
    AiAgentReviewRemediationEvent:
      allOf:
      - properties:
          createdByUserUuid:
            type:
            - string
            - 'null'
          occurredAt:
            type: string
            format: date-time
          remediationUuid:
            type: string
          uuid:
            type: string
        required:
        - createdByUserUuid
        - occurredAt
        - remediationUuid
        - uuid
        type: object
      - $ref: '#/components/schemas/AiAgentReviewRemediationEventDetail'
    ApiAiOrganizationSettingsResponse:
      $ref: '#/components/schemas/ApiSuccess_AiOrganizationSettings-and-ComputedAiOrganizationSettings_'
    AiAgentUser:
      properties:
        name:
          type: string
        uuid:
          type: string
      required:
      - name
      - uuid
      type: object
    AiAgentReviewSignalSummary:
      properties:
        finding:
          properties:
            recommendation:
              allOf:
              - $ref: '#/components/schemas/AiAgentRecommendation'
            evidenceExcerpts:
              items:
                $ref: '#/components/schemas/AiAgentEvidenceExcerpt'
              type: array
            fixTargets:
              items:
                $ref: '#/components/schemas/AiAgentFixTarget'
              type: array
            subcategories:
              items:
                type: string
              type: array
            primaryRootCause:
              $ref: '#/components/schemas/AiAgentRootCause'
            reviewItemUuid:
              type:
              - string
              - 'null'
            uuid:
              type: string
          required:
          - recommendation
          - evidenceExcerpts
          - fixTargets
          - subcategories
          - primaryRootCause
          - reviewItemUuid
          - uuid
          type:
          - object
          - 'null'
        errorMessage:
          type:
          - string
          - 'null'
        responsePreview:
          type:
          - string
          - 'null'
        prompt:
          type: string
        runScope:
          $ref: '#/components/schemas/AiAgentReviewClassifierRunScope'
        createdAt:
          type: string
          format: date-time
        promotionReason:
          type:
          - string
          - 'null'
        promotedToFinding:
          type: boolean
        confidence:
          $ref: '#/components/schemas/AiAgentReviewClassifierConfidence'
        implicitSignalSources:
          items:
            $ref: '#/components/schemas/AiAgentImplicitSignalSource'
          type: array
        signal:
          $ref: '#/components/schemas/AiAgentTurnSignal'
        agentUuid:
          type: string
        projectUuid:
          type: string
        threadUuid:
          type: string
        promptUuid:
          type: string
        runUuid:
          type: string
        uuid:
          type: string
      required:
      - finding
      - errorMessage
      - responsePreview
      - prompt
      - runScope
      - createdAt
      - promotionReason
      - promotedToFinding
      - confidence
      - implicitSignalSources
      - signal
      - agentUuid
      - projectUuid
      - threadUuid
      - promptUuid
      - runUuid
      - uuid
      type: object
    AiAgentFixTarget:
      type: string
      enum:
      - semantic_yaml_patch
      - project_context_rule
      - agent_configuration_change
      - dbt_modeling_ticket
      - semantic_layer_ticket
      - product_capability_ticket
      - runtime_reliability_ticket
      - feedback_needed
      - no_action
    AiAgentReviewItemPrState:
      type: string
      enum:
      - open
      - merged
      - closed
    AiAgentReviewRemediation:
      properties:
        updatedAt:
          type: string
          format: date-time
        createdAt:
          type: string
          format: date-time
        resolvedAt:
          type:
          - string
          - 'null'
          format: date-time
        resolvedByUserUuid:
          type:
          - string
          - 'null'
        createdByUserUuid:
          type:
          - string
          - 'null'
        retryPrompt:
          type:
          - string
          - 'null'
        errorMessage:
          type:
          - string
          - 'null'
        status:
          $ref: '#/components/schemas/AiAgentReviewRemediationStatus'
        previewThreadUuid:
          type:
          - string
          - 'null'
        previewAgentUuid:
          type:
          - string
          - 'null'
        previewProjectUuid:
          type:
          - string
          - 'null'
        linkedPrUrl:
          type:
          - string
          - 'null'
        pullRequestUuid:
          type:
          - string
          - 'null'
        sourceAgentUuid:
          type: string
        sourceProjectUuid:
          type: string
        sourceThreadUuid:
          type: string
        sourcePromptUuid:
          type: string
        sourceFindingUuid:
          type: string
        organizationUuid:
          type: string
        fingerprint:
          type: string
        uuid:
          type: string
      required:
      - updatedAt
      - createdAt
      - resolvedAt
      - resolvedByUserUuid
      - createdByUserUuid
      - retryPrompt
      - errorMessage
      - status
      - previewThreadUuid
      - previewAgentUuid
      - previewProjectUuid
      - linkedPrUrl
      - pullRequestUuid
      - sourceAgentUuid
      - sourceProjectUuid
      - sourceThreadUuid
      - sourcePromptUuid
      - sourceFindingUuid
      - organizationUuid
      - fingerprint
      - uuid
      type: object
    AiAgentReviewClassifierConfidence:
      type: string
      enum:
      - low
      - medium
      - high
    ApiAiAgentReviewItemPrDiffResponse:
      $ref: '#/components/schemas/ApiSuccess_AiAgentReviewItemPrDiff_'
    ApiErrorPayload:
      properties:
        error:
          properties:
            data:
              $ref: '#/components/schemas/AnyType'
              description: Optional data containing details of the error
            message:
              type: string
              description: A friendly message summarising the error
            name:
              type: string
              description: Unique name for the type of error
            statusCode:
              type: number
              format: integer
              description: HTTP status code
          required:
          - name
          - statusCode
          type: object
        status:
          type: string
          enum:
          - error
      required:
      - error
      - status
      type: object
      description: 'The Error object is returned from the api any time there is an error.

        The message contains'
    ApiAiAgentDocumentSummaryListResponse:
      properties:
        results:
          items:
            $ref: '#/components/schemas/AiAgentDocumentSummary'
          type: array
        status:
          type: string
          enum:
          - ok
      required:
      - results
      - status
      type: object
    AiAgentImplicitSignalSource:
      type: string
      enum:
      - next_user_correction
      - next_user_dispute
      - next_user_retry
      - output_shape_correction
      - tool_error
      - assistant_no_answer
      - product_capability_request
      - human_intervention
    ApiCreateAiAgentDocument:
      properties:
        agentAccess:
          items:
            type: string
          type: array
        projectUuid:
          type:
          - string
          - 'null'
        content:
          type: string
        mimeType:
          type: string
        originalFilename:
          type: string
        name:
          type: string
      required:
      - content
      - mimeType
      - originalFilename
      - name
      type: object
    AiAgentReviewItemActivity:
      properties:
        liveMessage:
          type:
          - string
          - 'null'
          description: Streaming progress text for the live row (writeback step messages).
        liveState:
          allOf:
          - $ref: '#/components/schemas/AiAgentReviewRemediationLiveState'
        events:
          items:
            $ref: '#/components/schemas/AiAgentReviewRemediationEvent'
          type: array
      required:
      - liveMessage
      - liveState
      - events
      type: object
    AiAgentConfigurationSetting:
      type: string
      enum:
      - instructions
      - knowledge_documents
      - data_access
      - self_improvement
      - sql_mode
      - mcp_servers
      - explore_tags
      - space_access
      - user_or_group_access
      - unknown
    AiAgentDocumentRelevance:
      type: string
      enum:
      - high
      - medium
      - low
      - none
    AiAgentAdminThreadSummary:
      allOf:
      - $ref: '#/components/schemas/ThreadSummary'
      - properties:
          slackThreadTs:
            type:
            - string
            - 'null'
          slackChannelId:
            type:
            - string
            - 'null'
          promptCount:
            type: number
            format: double
          feedbackSummary:
            $ref: '#/components/schemas/AiAgentAdminFeedbackSummary'
          project:
            properties:
              name:
                type: string
              uuid:
                type: string
            required:
            - name
            - uuid
            type: object
          agent:
            $ref: '#/components/schemas/Pick_AiAgentSummary.uuid-or-name-or-imageUrl_'
        required:
        - slackThreadTs
        - slackChannelId
        - promptCount
        - feedbackSummary
        - project
        - agent
        type: object
    AiAgentSemanticTargetRef:
      anyOf:
      - properties:
          modelName:
            type: string
          type:
            type: string
            enum:
            - model
        required:
        - modelName
        - type
        type: object
      - properties:
          exploreName:
            type: string
          modelName:
            type: string
          type:
            type: string
            enum:
            - explore
        required:
        - exploreName
        - modelName
        - type
        type: object
      - properties:
          exploreName:
            type: string
          joinName:
            type: string
          modelName:
            type: string
          type:
            type: string
            enum:
            - join
        required:
        - joinName
        - modelName
        - type
        type: object
      - properties:
          dimensionName:
            type: string
          modelName:
            type: string
          type:
            type: string
            enum:
            - dimension
        required:
        - dimensionName
        - modelName
        - type
        type: object
      - properties:
          dimensionName:
            type: string
          metricName:
            type: string
          modelName:
            type: string
          type:
            type: string
            enum:
            - metric
        required:
        - metricName
        - modelName
        - type
        type: object
      - properties:
          dimensionName:
            type: string
          parentDimensionName:
            type: string
          modelName:
            type: string
          type:
            type: string
            enum:
            - additional_dimension
        required:
        - dimensionName
        - parentDimensionName
        - modelName
        - type
        type: object
      - properties:
          fieldName:
            type: string
          exploreName:
            type: string
          modelName:
            type: string
          type:
            type: string
            enum:
            - required_filter
        required:
        - fieldName
        - exploreName
        - modelName
        - type
        type: object
      - properties:
          targetName:
            type: string
          targetType:
            type: string
            enum:
            - model
            - dimension
            - metric
          modelName:
            type: string
          type:
            type: string
            enum:
          

# --- truncated at 32 KB (59 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/lightdash/refs/heads/main/openapi/lightdash-aiagents-api-openapi.yml