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

# Get capabilities

> Returns a map of available API endpoints for the current target (cloud or local). Use this to discover which features are supported before calling other endpoints.

This endpoint does not require authentication.



## OpenAPI

````yaml /openapi.yaml get /v1/capabilities
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: >-
      Eval trial-result ingest: per-trial score rows plus full-fidelity artifact
      blobs.
    name: Evals
  - 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: 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: Per-app named environments (e.g. `dev`, `prod`). CRUD for env lifecycle.
    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: >-
      Cloud workers — terminal coding agents on managed compute. Launch one-shot
      runs or persistent multi-turn sessions against the app's connected repo;
      every response carries the dashboard deep link to the live thread.
    name: Workers
  - description: Service health checks.
    name: Health
paths:
  /v1/capabilities:
    get:
      tags:
        - Capabilities
      summary: Get capabilities
      description: >-
        Returns a map of available API endpoints for the current target (cloud
        or local). Use this to discover which features are supported before
        calling other endpoints.


        This endpoint does not require authentication.
      operationId: get-capabilities
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  endpoints:
                    properties:
                      datasets:
                        type: boolean
                      experiments:
                        type: boolean
                      metrics:
                        type: boolean
                      prompts:
                        type: boolean
                      runs:
                        type: boolean
                      score_analytics:
                        type: boolean
                      scores:
                        type: boolean
                      sessions:
                        type: boolean
                      spans:
                        type: boolean
                      traces:
                        type: boolean
                    required:
                      - traces
                      - spans
                      - sessions
                      - scores
                      - score_analytics
                      - metrics
                      - experiments
                      - datasets
                      - prompts
                      - runs
                    type: object
                  target:
                    enum:
                      - cloud
                    type: string
                  url:
                    type: string
                required:
                  - target
                  - url
                  - endpoints
                type: object
          description: Server capabilities.
      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

````