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

# Files health

> Check the health of the files service and its dependencies.



## OpenAPI

````yaml /openapi.yaml get /v1/health/files
openapi: 3.0.3
info:
  contact:
    email: hello@agentmark.co
    url: https://docs.agentmark.co
  description: >-
    The AgentMark Gateway API lets you ingest traces, create scores, and
    retrieve prompt templates programmatically.


    Most developers should use the [AgentMark SDK](/introduction/overview) for
    integration.

    The REST API is for cases where you need direct HTTP access or are building
    a custom integration.


    Versioning: every endpoint is prefixed with `/v1/`. Breaking changes ship
    under a new version prefix (`/v2/`, etc.) with a 90-day-minimum deprecation
    window — see [API versioning & stability](/api-reference/versioning) for the
    full policy on what constitutes a breaking vs. additive change.
  title: AgentMark Gateway API
  version: '1.0'
servers:
  - description: Production (AgentMark Cloud)
    url: https://api.agentmark.co
  - description: Local dev server (`npx @agentmark-ai/cli dev`)
    url: http://localhost:9418
security:
  - AppId: []
    BearerAuth: []
tags:
  - description: Ingest, query, and export OpenTelemetry trace data.
    name: Traces
  - description: >-
      Coding-agent session ingest (outerlayer sync) and content-addressed
      session images.
    name: Agents
  - description: Query individual spans across traces.
    name: Spans
  - description: Create, retrieve, list, and delete score records for spans and traces.
    name: Scoring
  - description: Structured-filter search across observability resources.
    name: Search
  - description: Retrieve the effective synced project configuration.
    name: Config
  - description: List and retrieve datasets.
    name: Datasets
  - description: Query server feature availability.
    name: Capabilities
  - description: Per-model LLM pricing data. Public, unauthenticated.
    name: Pricing
  - description: >-
      Create, list, and revoke tenant API keys. Plaintext returned exactly once
      at creation.
    name: API Keys
  - description: >-
      List and retrieve score configuration definitions from the synced project
      config.
    name: Score Configs
  - description: >-
      Trigger and inspect managed deployments. POST returns 202; deployments run
      asynchronously and progress is observed via GET.
    name: Deployments
  - description: >-
      Per-app named environments (e.g. `dev`, `prod`). CRUD for env lifecycle;
      promote/rollback routes land alongside in this group as feature 054 lands
      the saga.
    name: Environments
  - description: >-
      App CRUD — the top-level tenant entity every other resource hangs off.
      Lets a headless agent provision an app without the dashboard.
    name: Apps
  - description: Service health checks.
    name: Health
paths:
  /v1/health/files:
    get:
      tags:
        - Health
      summary: Files health
      description: Check the health of the files service and its dependencies.
      operationId: files-health
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  component:
                    type: string
                  dependencies:
                    items:
                      properties:
                        error:
                          type: string
                        latencyMs:
                          type: number
                        name:
                          type: string
                        status:
                          enum:
                            - healthy
                            - unhealthy
                          type: string
                      required:
                        - name
                        - status
                      type: object
                    type: array
                  status:
                    enum:
                      - healthy
                      - degraded
                      - unhealthy
                    type: string
                  timestamp:
                    format: date-time
                    type: string
                required:
                  - status
                  - component
                  - timestamp
                  - dependencies
                type: object
          description: Files service is healthy or degraded.
        '503':
          content:
            application/json:
              schema:
                properties:
                  component:
                    type: string
                  dependencies:
                    items:
                      properties:
                        error:
                          type: string
                        latencyMs:
                          type: number
                        name:
                          type: string
                        status:
                          enum:
                            - healthy
                            - unhealthy
                          type: string
                      required:
                        - name
                        - status
                      type: object
                    type: array
                  status:
                    enum:
                      - healthy
                      - degraded
                      - unhealthy
                    type: string
                  timestamp:
                    format: date-time
                    type: string
                required:
                  - status
                  - component
                  - timestamp
                  - dependencies
                type: object
          description: Files service is unhealthy.
      security: []
components:
  securitySchemes:
    AppId:
      description: >-
        Application ID for tenant scoping. X-Outerlayer-App-Id is accepted as an
        equivalent header.
      in: header
      name: X-Agentmark-App-Id
      type: apiKey
    BearerAuth:
      description: API key (sk_agentmark_*)
      scheme: bearer
      type: http

````