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

# Context Status

> Status of your knowledge context: the latest snapshot in storage, whether
it is loaded and ready to serve queries, and whether the loaded snapshot is
current. Returns snapshot info even when nothing is loaded yet.

<Snippet file="api/knowledge/context-status.mdx" />


## OpenAPI

````yaml GET /v1/knowledge/status
openapi: 3.1.0
info:
  title: Adapter API
  description: Connect and sync data from any SaaS tool.
  version: 0.1.0
servers:
  - url: https://api.adapter.com
security:
  - ApiKeyAuth: []
tags:
  - name: connections
    description: Manage OAuth connections to data sources.
paths:
  /v1/knowledge/status:
    get:
      tags:
        - knowledge
      summary: Context Status
      description: >-
        Status of your knowledge context: the latest snapshot in storage,
        whether

        it is loaded and ready to serve queries, and whether the loaded snapshot
        is

        current. Returns snapshot info even when nothing is loaded yet.
      operationId: context_status
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContextStatusResponse'
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthenticationErrorModel'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PermissionDeniedErrorModel'
          description: Forbidden
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerErrorModel'
          description: Internal Server Error
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceUnavailableErrorModel'
components:
  schemas:
    ContextStatusResponse:
      properties:
        latest_snapshot:
          anyOf:
            - type: string
            - type: 'null'
          title: Latest Snapshot
          description: >-
            Identifier of the most recent snapshot in storage. `None` when no
            refresh has succeeded yet for this workspace.
        latest_built_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Latest Built At
          description: ISO-8601 last-modified timestamp of the latest snapshot.
        loaded:
          type: boolean
          title: Loaded
          description: >-
            Whether your knowledge context is currently loaded and ready to
            serve queries. When `false`, the first query pays a cold-start cost.
        loaded_snapshot:
          anyOf:
            - type: string
            - type: 'null'
          title: Loaded Snapshot
          description: >-
            Snapshot the loaded context is serving. May lag behind
            `latest_snapshot` if a newer refresh finished after the context was
            loaded.
        evidence_watermark:
          anyOf:
            - type: string
            - type: 'null'
          title: Evidence Watermark
          description: >-
            Ingestion watermark of the loaded snapshot: when its newest record
            was ingested, not when that record occurred; present only when
            `loaded` is true.
        up_to_date:
          type: boolean
          title: Up To Date
          description: >-
            True iff `loaded_snapshot == latest_snapshot` (and both are
            present).
        evidence_types:
          anyOf:
            - additionalProperties:
                type: integer
              type: object
            - type: 'null'
          title: Evidence Types
          description: >-
            Count of your current records by type. Omitted when the counts are
            temporarily unavailable — absent means unknown, not zero.
        earliest_evidence_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Earliest Evidence At
          description: >-
            Timestamp of your oldest record (when it occurred, not when it was
            ingested).
        latest_evidence_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Latest Evidence At
          description: >-
            Timestamp of your newest record (when it occurred, not when it was
            ingested).
      type: object
      required:
        - loaded
        - up_to_date
      title: ContextStatusResponse
    AuthenticationErrorModel:
      properties:
        error_code:
          type: string
          const: authentication_error
          title: Error Code
          default: authentication_error
        message:
          type: string
          title: Message
          default: Invalid or missing credentials.
        details:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Details
      type: object
      title: AuthenticationErrorModel
    PermissionDeniedErrorModel:
      properties:
        error_code:
          type: string
          const: permission_denied
          title: Error Code
          default: permission_denied
        message:
          type: string
          title: Message
          default: You do not have permission to perform this action.
        details:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Details
      type: object
      title: PermissionDeniedErrorModel
    InternalServerErrorModel:
      properties:
        error_code:
          type: string
          const: internal_server_error
          title: Error Code
          default: internal_server_error
        message:
          type: string
          title: Message
          default: An unexpected error occurred.
        details:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Details
      type: object
      title: InternalServerErrorModel
    ServiceUnavailableErrorModel:
      properties:
        error_code:
          type: string
          const: service_unavailable
          title: Error Code
          default: service_unavailable
        message:
          type: string
          title: Message
          default: >-
            The service is currently experiencing issues. Please try again
            later.
        details:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Details
      type: object
      title: ServiceUnavailableErrorModel
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      description: Pass your `pk_live_...` API key as a Bearer token.

````