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

# Query knowledge-base evidence

> Runs a query against the knowledge base selected by the server URL and returns one JSON response. The S&P 500 request examples apply to baseline/sandp500; use queries and metadata fields appropriate to your selected base.



## OpenAPI

````yaml /openapi.json post /query
openapi: 3.1.0
info:
  title: AI Baseline API
  description: >-
    REST v2 contract for querying a selected knowledge base, discovering
    metadata filters, and reading corpus orientation. The S&P 500 requests are
    worked examples; fields and available material depend on the selected base
    and its domain.
  version: v2
servers:
  - url: https://api.ai-baseline.dev/{org}/{base}/v2
    description: Knowledge-base REST API (defaults to the S&P 500 example)
    variables:
      org:
        default: baseline
        description: Exact identifier of the organization that owns the knowledge base.
      base:
        default: sandp500
        description: >-
          Exact identifier of the knowledge base within the owning organization.
          The API key must grant access to this base.
security:
  - ApiKeyAuth: []
paths:
  /query:
    post:
      tags:
        - Queries
      summary: Query knowledge-base evidence
      description: >-
        Runs a query against the knowledge base selected by the server URL and
        returns one JSON response. The S&P 500 request examples apply to
        baseline/sandp500; use queries and metadata fields appropriate to your
        selected base.
      operationId: runResearchQuery
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResearchRequest'
            examples:
              basic:
                summary: Minimal S&P 500 evidence retrieval
                value:
                  query: >-
                    What supply chain risks did Apple disclose in its 10-K
                    filings?
              research:
                summary: Metadata-aware evidence retrieval
                value:
                  query: What are the key risks in AAPL's latest 10-K?
                  mode: research
                  effort: medium
                  metadata_filters:
                    sec_ticker: AAPL
                    sec_form_type: 10-K
                  include:
                    metadata_distribution: true
                    metadata_dashboard: true
                    summary: true
              agentic_research:
                summary: Decomposed evidence retrieval
                value:
                  query: Compare demand risks for AAPL and MSFT.
                  mode: agentic_research
                  effort: high
                  metadata_filters:
                    sec_ticker:
                      - AAPL
                      - MSFT
                  include:
                    summary: true
              retrieval_only:
                summary: Rendered evidence-only retrieval
                value:
                  query: Show evidence for AAPL supply-chain risks.
                  mode: research
                  effort: medium
                  metadata_filters:
                    sec_ticker: AAPL
                  include:
                    evidence: true
                    evidence_format: rendered
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResearchResponse'
        '404':
          description: Unknown domain
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '413':
          description: Request body too large
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestFailureResponse'
        '502':
          description: An AI upstream returned output that failed validation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestFailureResponse'
        '503':
          description: Service, AI dependency, or local capacity temporarily unavailable
          headers:
            Retry-After:
              description: Advisory delay in seconds for retryable failures
              schema:
                type: integer
                minimum: 1
          content:
            application/json:
              examples:
                capacity_queue_full:
                  summary: The bounded capacity waiting room is full
                  value:
                    status_code: 503
                    message: Service temporarily at capacity
                    detail:
                      code: CAPACITY_UNAVAILABLE
                      retryable: true
                      reason: queue_full
                      retry_after_seconds: 5
                capacity_wait_timeout:
                  summary: Capacity was not acquired before the wait timeout
                  value:
                    status_code: 503
                    message: Service temporarily at capacity
                    detail:
                      code: CAPACITY_UNAVAILABLE
                      retryable: true
                      reason: wait_timeout
                      retry_after_seconds: 5
                dependency_unavailable:
                  summary: A required AI upstream service is unavailable
                  value:
                    status_code: 503
                    message: >-
                      A required AI upstream service is temporarily unavailable.
                      Please retry.
                    detail:
                      code: DEPENDENCY_UNAVAILABLE
                      retryable: true
                      retry_after_seconds: 10
                service_unavailable:
                  summary: Application services are unavailable
                  value:
                    status_code: 503
                    message: Service unavailable
                    detail:
                      code: SERVICE_UNAVAILABLE
                      retryable: false
              schema:
                $ref: '#/components/schemas/RequestFailureResponse'
        '504':
          description: The admitted request exceeded its execution deadline
          headers:
            Retry-After:
              description: Advisory delay in seconds before retrying
              schema:
                type: integer
                minimum: 1
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestFailureResponse'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    ResearchRequest:
      properties:
        query:
          type: string
          title: Query
        mode:
          type: string
          enum:
            - basic
            - research
            - agentic_research
          title: Mode
          default: basic
        effort:
          type: string
          enum:
            - low
            - medium
            - high
          title: Effort
          default: medium
        metadata_filters:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Metadata Filters
        include:
          $ref: '#/components/schemas/IncludeOptions'
        retrieval:
          anyOf:
            - $ref: '#/components/schemas/RetrievalControls'
            - type: 'null'
        images:
          anyOf:
            - $ref: '#/components/schemas/ImageDeliveryControls'
            - type: 'null'
      additionalProperties: false
      type: object
      required:
        - query
      title: ResearchRequest
    ResearchResponse:
      properties:
        request_id:
          type: string
          title: Request Id
        notices:
          items:
            $ref: '#/components/schemas/NoticePayload'
          type: array
          title: Notices
        metadata_distribution:
          additionalProperties: true
          type: object
          title: Metadata Distribution
        metadata_dashboard:
          type: string
          title: Metadata Dashboard
        evidence:
          type: string
          title: Evidence
        evidence_instructions:
          type: string
          title: Evidence Instructions
        agent_context:
          $ref: '#/components/schemas/AgentContextPayload'
          title: Agent Context
        source_links:
          $ref: '#/components/schemas/SourceLinksPayload'
          title: Source Links
        image_evidence:
          $ref: '#/components/schemas/ImageEvidencePayload'
          title: Image Evidence
        summary:
          $ref: '#/components/schemas/ResponseSummary'
          title: Summary
        coverage:
          $ref: '#/components/schemas/CoveragePayload'
          title: Coverage
        evidence_budget:
          $ref: '#/components/schemas/EvidenceBudgetPayload'
          title: Evidence Budget
        retrieval_plan:
          $ref: '#/components/schemas/RetrievalPlanPayload'
          title: Retrieval Plan
      additionalProperties: false
      type: object
      required:
        - request_id
      title: ResearchResponse
      description: Strict allowlist for every public production query response.
    ErrorResponse:
      properties:
        status_code:
          type: integer
          title: Status Code
        message:
          type: string
          title: Message
        detail:
          anyOf:
            - {}
            - type: 'null'
          title: Detail
      type: object
      required:
        - status_code
        - message
      title: ErrorResponse
    RequestFailureResponse:
      properties:
        status_code:
          type: integer
          enum:
            - 500
            - 502
            - 503
            - 504
          title: Status Code
        message:
          type: string
          title: Message
        detail:
          $ref: '#/components/schemas/RequestFailureDetail'
      additionalProperties: false
      type: object
      required:
        - status_code
        - message
        - detail
      title: RequestFailureResponse
    IncludeOptions:
      properties:
        evidence:
          type: boolean
          title: Evidence
          default: true
        evidence_instructions:
          type: boolean
          title: Evidence Instructions
          default: true
        agent_context:
          type: boolean
          title: Agent Context
          default: false
        source_links:
          type: boolean
          title: Source Links
          default: true
        images:
          type: boolean
          title: Images
          default: false
        evidence_format:
          type: string
          enum:
            - rendered
            - xml
          title: Evidence Format
          default: rendered
        metadata_distribution:
          type: boolean
          title: Metadata Distribution
          default: false
        metadata_dashboard:
          type: boolean
          title: Metadata Dashboard
          default: false
        summary:
          type: boolean
          title: Summary
          default: true
      additionalProperties: false
      type: object
      title: IncludeOptions
    RetrievalControls:
      properties:
        max_evidence:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
          title: Max Evidence
        max_evidence_tokens:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
          title: Max Evidence Tokens
      additionalProperties: false
      type: object
      title: RetrievalControls
    ImageDeliveryControls:
      properties:
        max_count:
          type: integer
          maximum: 8
          minimum: 1
          title: Max Count
          default: 4
        max_total_bytes:
          type: integer
          maximum: 67108864
          minimum: 1
          title: Max Total Bytes
          default: 33554432
      additionalProperties: false
      type: object
      title: ImageDeliveryControls
    NoticePayload:
      properties:
        code:
          type: string
          title: Code
        message:
          type: string
          title: Message
      additionalProperties: false
      type: object
      required:
        - code
        - message
      title: NoticePayload
    AgentContextPayload:
      properties:
        content_type:
          type: string
          const: text/markdown
          title: Content Type
          default: text/markdown
        text:
          type: string
          title: Text
        source_fields:
          items:
            type: string
          type: array
          title: Source Fields
        content_parts:
          items:
            anyOf:
              - $ref: '#/components/schemas/AgentContextTextPart'
              - $ref: '#/components/schemas/AgentContextImageReferencePart'
          type: array
          title: Content Parts
      additionalProperties: false
      type: object
      required:
        - text
      title: AgentContextPayload
    SourceLinksPayload:
      properties:
        status:
          type: string
          enum:
            - complete
            - partial
          title: Status
        total_sources:
          type: integer
          minimum: 0
          title: Total Sources
        returned_sources:
          type: integer
          minimum: 0
          title: Returned Sources
        total_passages:
          type: integer
          minimum: 0
          title: Total Passages
        returned_passages:
          type: integer
          minimum: 0
          title: Returned Passages
        sources:
          additionalProperties:
            $ref: '#/components/schemas/SourceLinkPayload'
          type: object
          title: Sources
      additionalProperties: false
      type: object
      required:
        - status
        - total_sources
        - returned_sources
        - total_passages
        - returned_passages
        - sources
      title: SourceLinksPayload
    ImageEvidencePayload:
      properties:
        schema_version:
          type: integer
          const: 1
          title: Schema Version
          default: 1
        status:
          type: string
          enum:
            - complete
            - partial
            - none
          title: Status
        total_selected_images:
          type: integer
          minimum: 0
          title: Total Selected Images
        returned_images:
          type: integer
          minimum: 0
          title: Returned Images
        returned_bytes:
          type: integer
          minimum: 0
          title: Returned Bytes
        images:
          additionalProperties:
            $ref: '#/components/schemas/ImageReferencePayload'
          type: object
          title: Images
        bindings:
          items:
            $ref: '#/components/schemas/ImageEvidenceBindingPayload'
          type: array
          title: Bindings
        omissions:
          items:
            $ref: '#/components/schemas/ImageEvidenceOmissionPayload'
          type: array
          title: Omissions
      additionalProperties: false
      type: object
      required:
        - status
        - total_selected_images
        - returned_images
        - returned_bytes
        - images
        - bindings
        - omissions
      title: ImageEvidencePayload
    ResponseSummary:
      properties:
        domain:
          type: string
          title: Domain
          description: >-
            Configured domain ID of the selected knowledge base, not its base
            identifier. For the baseline/sandp500 example this is sandp_500.
        mode:
          type: string
          enum:
            - basic
            - research
            - agentic_research
          title: Mode
        effort:
          type: string
          enum:
            - low
            - medium
            - high
          title: Effort
        submitted_metadata_filters:
          additionalProperties: true
          type: object
          title: Submitted Metadata Filters
        applied_metadata_filters:
          additionalProperties: true
          type: object
          title: Applied Metadata Filters
        evidence_count:
          type: integer
          title: Evidence Count
        warnings:
          items:
            type: string
          type: array
          title: Warnings
      additionalProperties: false
      type: object
      required:
        - domain
        - mode
        - effort
        - evidence_count
      title: ResponseSummary
    CoveragePayload:
      properties:
        status:
          type: string
          enum:
            - complete
            - partial
            - none
            - not_assessed
          title: Status
        requirement_count:
          type: integer
          minimum: 0
          title: Requirement Count
        covered_requirement_count:
          type: integer
          minimum: 0
          title: Covered Requirement Count
        requirements:
          items:
            $ref: '#/components/schemas/CoverageRequirementPayload'
          type: array
          title: Requirements
        omitted_requirements:
          items:
            type: string
          type: array
          title: Omitted Requirements
        limitations:
          items:
            type: string
            enum:
              - planning_fallback
              - requirement_limit
              - missing_evidence
              - token_budget
          type: array
          title: Limitations
      additionalProperties: false
      type: object
      required:
        - status
        - requirement_count
        - covered_requirement_count
      title: CoveragePayload
    EvidenceBudgetPayload:
      properties:
        requested_max_tokens:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
          title: Requested Max Tokens
        estimator:
          type: string
          const: chars_div_4_v1
          title: Estimator
          default: chars_div_4_v1
        estimated_tokens:
          type: integer
          minimum: 0
          title: Estimated Tokens
        available_evidence_count:
          type: integer
          minimum: 0
          title: Available Evidence Count
        returned_evidence_count:
          type: integer
          minimum: 0
          title: Returned Evidence Count
        truncated:
          type: boolean
          title: Truncated
      additionalProperties: false
      type: object
      required:
        - estimated_tokens
        - available_evidence_count
        - returned_evidence_count
        - truncated
      title: EvidenceBudgetPayload
    RetrievalPlanPayload:
      properties:
        queries:
          items:
            $ref: '#/components/schemas/RetrievalPlanQueryPayload'
          type: array
          title: Queries
      additionalProperties: false
      type: object
      title: RetrievalPlanPayload
    RequestFailureDetail:
      properties:
        code:
          $ref: '#/components/schemas/FailureCode'
        retryable:
          type: boolean
          title: Retryable
        reason:
          anyOf:
            - type: string
              enum:
                - queue_full
                - wait_timeout
            - type: 'null'
          title: Reason
        retry_after_seconds:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
          title: Retry After Seconds
      additionalProperties: false
      type: object
      required:
        - code
        - retryable
      title: RequestFailureDetail
    AgentContextTextPart:
      properties:
        type:
          type: string
          const: text
          title: Type
          default: text
        text:
          type: string
          title: Text
      additionalProperties: false
      type: object
      required:
        - text
      title: AgentContextTextPart
    AgentContextImageReferencePart:
      properties:
        type:
          type: string
          const: image_ref
          title: Type
          default: image_ref
        image_ref:
          type: string
          pattern: ^image_[1-9][0-9]*$
          title: Image Ref
      additionalProperties: false
      type: object
      required:
        - image_ref
      title: AgentContextImageReferencePart
    SourceLinkPayload:
      properties:
        artifact:
          type: string
          const: ingested_text
          title: Artifact
          default: ingested_text
        document:
          anyOf:
            - $ref: '#/components/schemas/ViewerUrlPayload'
            - type: 'null'
        reason:
          anyOf:
            - type: string
              enum:
                - artifact_missing
                - artifact_invalid
                - artifact_too_large
                - lineage_unavailable
                - quote_missing
                - quote_not_found
                - quote_ambiguous
                - capacity_exceeded
                - deadline_exceeded
                - dependency_unavailable
                - scope_not_allowed
            - type: 'null'
          title: Reason
        passages:
          additionalProperties:
            $ref: '#/components/schemas/PassageLinkPayload'
          type: object
          title: Passages
      additionalProperties: false
      type: object
      required:
        - passages
      title: SourceLinkPayload
    ImageReferencePayload:
      properties:
        image_id:
          type: string
          pattern: ^im_[0-9a-f]{64}$
          title: Image Id
        source_id:
          type: string
          minLength: 1
          title: Source Id
        version_id:
          type: string
          minLength: 1
          title: Version Id
        chunk_id:
          type: string
          minLength: 1
          title: Chunk Id
        mime_type:
          type: string
          const: image/png
          title: Mime Type
        width:
          type: integer
          exclusiveMinimum: 0
          title: Width
        height:
          type: integer
          exclusiveMinimum: 0
          title: Height
        byte_length:
          type: integer
          exclusiveMinimum: 0
          title: Byte Length
        sha256:
          type: string
          pattern: ^sha256:[0-9a-f]{64}$
          title: Sha256
        url:
          type: string
          minLength: 1
          title: Url
        expires_at:
          type: string
          format: date-time
          title: Expires At
        location:
          anyOf:
            - $ref: '#/components/schemas/ImageSourceLocationV1'
            - type: 'null'
        context:
          items:
            $ref: '#/components/schemas/ImageSourceContextPayload'
          type: array
          title: Context
          default: []
      additionalProperties: false
      type: object
      required:
        - image_id
        - source_id
        - version_id
        - chunk_id
        - mime_type
        - width
        - height
        - byte_length
        - sha256
        - url
        - expires_at
      title: ImageReferencePayload
    ImageEvidenceBindingPayload:
      properties:
        evidence_id:
          type: string
          pattern: ^e_(?:[0-9a-f]{64}|[0-9a-f]{7}(?:_[0-9]{2,})?)$
          title: Evidence Id
        entry_id:
          type: string
          pattern: ^(?:n_[0-9a-f]{64}|e_[0-9a-f]{7}(?:_[0-9]{2,})?)$
          title: Entry Id
        image_refs:
          items:
            type: string
          type: array
          minItems: 1
          title: Image Refs
        support_kind:
          type: string
          enum:
            - visual
            - both
          title: Support Kind
      additionalProperties: false
      type: object
      required:
        - evidence_id
        - entry_id
        - image_refs
        - support_kind
      title: ImageEvidenceBindingPayload
    ImageEvidenceOmissionPayload:
      properties:
        evidence_id:
          type: string
          pattern: ^e_(?:[0-9a-f]{64}|[0-9a-f]{7}(?:_[0-9]{2,})?)$
          title: Evidence Id
        entry_id:
          type: string
          pattern: ^(?:n_[0-9a-f]{64}|e_[0-9a-f]{7}(?:_[0-9]{2,})?)$
          title: Entry Id
        reason:
          type: string
          enum:
            - image_count_budget
            - image_byte_budget
            - context_budget
            - asset_missing
            - asset_unavailable
            - lineage_unavailable
            - mcp_result_budget
          title: Reason
      additionalProperties: false
      type: object
      required:
        - evidence_id
        - entry_id
        - reason
      title: ImageEvidenceOmissionPayload
    CoverageRequirementPayload:
      properties:
        id:
          type: string
          title: Id
        label:
          type: string
          title: Label
        query:
          type: string
          title: Query
        status:
          type: string
          enum:
            - covered
            - missing
            - omitted_by_budget
          title: Status
        retrieved_evidence_count:
          type: integer
          minimum: 0
          title: Retrieved Evidence Count
        returned_evidence_count:
          type: integer
          minimum: 0
          title: Returned Evidence Count
      additionalProperties: false
      type: object
      required:
        - id
        - label
        - query
        - status
        - retrieved_evidence_count
        - returned_evidence_count
      title: CoverageRequirementPayload
    RetrievalPlanQueryPayload:
      properties:
        query:
          type: string
          title: Query
        label:
          type: string
          title: Label
        applied_metadata_filters:
          additionalProperties: true
          type: object
          title: Applied Metadata Filters
      additionalProperties: false
      type: object
      required:
        - query
      title: RetrievalPlanQueryPayload
    FailureCode:
      type: string
      enum:
        - CAPACITY_UNAVAILABLE
        - DEPENDENCY_UNAVAILABLE
        - SERVICE_UNAVAILABLE
        - INVALID_UPSTREAM_RESPONSE
        - EXECUTION_DEADLINE_EXCEEDED
        - EXECUTION_WORK_LIMIT_EXCEEDED
        - INTERNAL_SERVER_ERROR
      title: FailureCode
    ViewerUrlPayload:
      properties:
        url:
          type: string
          minLength: 1
          title: Url
        expires_at:
          type: string
          format: date-time
          title: Expires At
      additionalProperties: false
      type: object
      required:
        - url
        - expires_at
      title: ViewerUrlPayload
    PassageLinkPayload:
      properties:
        precision:
          type: string
          enum:
            - exact
            - chunk
            - unavailable
          title: Precision
        reason:
          anyOf:
            - type: string
              enum:
                - artifact_missing
                - artifact_invalid
                - artifact_too_large
                - lineage_unavailable
                - quote_missing
                - quote_not_found
                - quote_ambiguous
                - capacity_exceeded
                - deadline_exceeded
                - dependency_unavailable
                - scope_not_allowed
            - type: 'null'
          title: Reason
        target:
          anyOf:
            - $ref: '#/components/schemas/ViewerUrlPayload'
            - type: 'null'
        evidence_refs:
          items:
            $ref: '#/components/schemas/EvidenceReferencePayload'
          type: array
          title: Evidence Refs
        audio:
          anyOf:
            - $ref: '#/components/schemas/AudioPassagePayload'
            - type: 'null'
      additionalProperties: false
      type: object
      required:
        - precision
        - evidence_refs
      title: PassageLinkPayload
    ImageSourceLocationV1:
      properties:
        page_number:
          anyOf:
            - type: integer
              exclusiveMinimum: 0
            - type: 'null'
          title: Page Number
        section_id:
          anyOf:
            - type: string
              maxLength: 2000
              minLength: 1
            - type: 'null'
          title: Section Id
        region:
          anyOf:
            - $ref: '#/components/schemas/ImagePageRegionV1'
            - type: 'null'
      additionalProperties: false
      type: object
      title: ImageSourceLocationV1
      description: Optional source location, never inferred from model output or filenames.
    ImageSourceContextPayload:
      properties:
        source_chunk_id:
          type: string
          minLength: 1
          title: Source Chunk Id
        start_char:
          type: integer
          minimum: 0
          title: Start Char
        end_char:
          type: integer
          exclusiveMinimum: 0
          title: End Char
        text:
          type: string
          maxLength: 4000
          minLength: 1
          title: Text
        role:
          type: string
          enum:
            - caption
            - before
            - after
            - explicit
          title: Role
      additionalProperties: false
      type: object
      required:
        - source_chunk_id
        - start_char
        - end_char
        - text
        - role
      title: ImageSourceContextPayload
    EvidenceReferencePayload:
      properties:
        evidence_id:
          type: string
          pattern: ^e_(?:[0-9a-f]{64}|[0-9a-f]{7}(?:_[0-9]{2,})?)$
          title: Evidence Id
        entry_id:
          type: string
          pattern: ^(?:n_[0-9a-f]{64}|e_[0-9a-f]{7}(?:_[0-9]{2,})?)$
          title: Entry Id
      additionalProperties: false
      type: object
      required:
        - evidence_id
        - entry_id
      title: EvidenceReferencePayload
    AudioPassagePayload:
      properties:
        audio_id:
          type: string
          pattern: ^au_[0-9a-f]{64}$
          title: Audio Id
        occurrence_id:
          type: string
          minLength: 1
          title: Occurrence Id
        transcript_variant:
          type: string
          enum:
            - raw_asr
            - cleaned_transcript
          title: Transcript Variant
        segment_ids:
          items:
            type: string
          type: array
          minItems: 1
          title: Segment Ids
        time_spans:
          items:
            $ref: '#/components/schemas/AudioTimeSpanV1'
          type: array
          minItems: 1
          title: Time Spans
        transcript_text_precision:
          type: string
          enum:
            - exact
            - chunk
          title: Transcript Text Precision
        audio_precision:
          type: string
          const: segment
          title: Audio Precision
        speaker_availability:
          type: string
          const: not_provided
          title: Speaker Availability
        target:
          anyOf:
            - $ref: '#/components/schemas/AudioTargetPayload'
            - type: 'null'
        reason:
          anyOf:
            - type: string
              enum:
                - asset_missing
                - asset_unavailable
                - lineage_unavailable
                - scope_not_allowed
                - capacity_exceeded
                - deadline_exceeded
                - format_unavailable
            - type: 'null'
          title: Reason
      additionalProperties: false
      type: object
      required:
        - audio_id
        - occurrence_id
        - transcript_variant
        - segment_ids
        - time_spans
        - transcript_text_precision
        - audio_precision
        - speaker_availability
      title: AudioPassagePayload
    ImagePageRegionV1:
      properties:
        coordinate_system:
          type: string
          enum:
            - pixels
            - normalized
          title: Coordinate System
        page_width:
          type: number
          exclusiveMinimum: 0
          title: Page Width
        page_height:
          type: number
          exclusiveMinimum: 0
          title: Page Height
        x:
          type: number
          minimum: 0
          title: X
        'y':
          type: number
          minimum: 0
          title: 'Y'
        width:
          type: number
          exclusiveMinimum: 0
          title: Width
        height:
          type: number
          exclusiveMinimum: 0
          title: Height
      additionalProperties: false
      type: object
      required:
        - coordinate_system
        - page_width
        - page_height
        - x
        - 'y'
        - width
        - height
      title: ImagePageRegionV1
      description: >-
        Producer-declared rectangle; normalized coordinates range from zero to
        one.
    AudioTimeSpanV1:
      properties:
        start_ms:
          type: integer
          minimum: 0
          title: Start Ms
        end_ms:
          type: integer
          exclusiveMinimum: 0
          title: End Ms
      additionalProperties: false
      type: object
      required:
        - start_ms
        - end_ms
      title: AudioTimeSpanV1
      description: >-
        Nonnegative, end-exclusive integer millisecond interval on its declared
        clock.
    AudioTargetPayload:
      properties:
        url:
          type: string
          minLength: 1
          title: Url
        expires_at:
          type: string
          format: date-time
          title: Expires At
      additionalProperties: false
      type: object
      required:
        - url
        - expires_at
      title: AudioTargetPayload
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.