Acrux Core Traces API

openapi: 3.2.0
info:
  title: Acrux Core Traces API
  version: '2026-10-15'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-15: 20 operation(s) read from 6 public documentation page(s) (each operation names its page in x-source). This is not the provider''s published contract; Acrux Core has published no machine-readable contract that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 3
    documentation: 17
    pages-with-code: 2
    pages-read: 6
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-15'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.acruxcore.com/docs/guides/store-prompts-and-tools-via-api
  - https://docs.acruxcore.com/api-reference/audit
  - https://docs.acruxcore.com/api-reference/tools
  - https://docs.acruxcore.com/api-reference/export
  - https://docs.acruxcore.com/api-reference/import
  - https://docs.acruxcore.com/api-reference/traces
servers:
- url: https://api.acruxcore.com
security:
- bearer: []
tags:
- name: Traces
paths:
  /api/v1/traces/{id}:
    get:
      operationId: get_api_v1_traces_id
      tags:
      - Traces
      summary: Traces API
      x-source: https://docs.acruxcore.com/api-reference/traces
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1TracesIdResponse'
      x-evidence:
        kind: documentation
  /api/v1/traces/facets/values:
    get:
      operationId: get_api_v1_traces_facets_values
      tags:
      - Traces
      summary: Traces API
      x-source: https://docs.acruxcore.com/api-reference/traces
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1TracesFacetsValuesResponse'
      x-evidence:
        kind: documentation
  /traces:
    get:
      operationId: get_traces
      tags:
      - Traces
      summary: Traces API
      x-source: https://docs.acruxcore.com/api-reference/traces
      parameters:
      - name: from
        in: query
        required: false
        schema:
          type: string
        description: ISO‑8601 start of created_at window.
      - name: to
        in: query
        required: false
        schema:
          type: string
        description: ISO‑8601 end of created_at window.
      - name: status
        in: query
        required: false
        schema:
          type: string
        description: Filter by trace status (ok, error, unset).
      - name: model
        in: query
        required: false
        schema:
          type: string
        description: Exact match against any span model.
      - name: session_id
        in: query
        required: false
        schema:
          type: string
        description: Exact match against any span session_id.
      - name: prompt_version_id
        in: query
        required: false
        schema:
          type: string
        description: Exact match against any span prompt_version_id.
      - name: prompt_id
        in: query
        required: false
        schema:
          type: string
        description: Match any version of the given prompt.
      - name: min_latency_ms
        in: query
        required: false
        schema:
          type: integer
        description: Inclusive lower bound on latency.
      - name: min_cost_usd
        in: query
        required: false
        schema:
          type: number
        description: Inclusive lower bound on total cost.
      - name: min_tokens
        in: query
        required: false
        schema:
          type: integer
        description: Inclusive lower bound on total tokens.
      - name: error_type
        in: query
        required: false
        schema:
          type: string
        description: Filter by error type.
      - name: error_code
        in: query
        required: false
        schema:
          type: string
        description: Filter by error code.
      - name: has_warning
        in: query
        required: false
        schema:
          type: boolean
        description: Filter traces that have warnings.
      - name: q
        in: query
        required: false
        schema:
          type: string
        description: Free‑text search over names, attributes, input/output.
      - name: q_in
        in: query
        required: false
        schema:
          type: string
        description: Limit q to input, output, or name.
      - name: tags
        in: query
        required: false
        schema:
          type: array
        description: Repeatable tag filter (AND semantics).
      - name: metadata
        in: query
        required: false
        schema:
          type: object
        description: Repeatable metadata key/value filter (AND semantics).
      - name: page
        in: query
        required: false
        schema:
          type: integer
        description: Page number (default 1).
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Page size (default 20, max 100).
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTracesResponse'
      x-evidence:
        kind: documentation
  /traces/{id}:
    get:
      operationId: get_traces_id
      tags:
      - Traces
      summary: Traces API
      x-source: https://docs.acruxcore.com/api-reference/traces
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTracesIdResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetTracesIdResponse:
      type: object
      properties:
        trace:
          type: object
        spans:
          type: array
    GetApiV1TracesFacetsValuesResponse:
      type: object
      properties:
        values:
          type: array
          description: All distinct facet values.
    GetTracesResponse:
      type: object
      properties:
        data:
          type: array
          description: Array of trace summary objects.
        total:
          type: integer
          description: Total number of matching traces.
        page:
          type: integer
          description: Current page.
        limit:
          type: integer
          description: Page size.
    GetApiV1TracesIdResponse:
      type: object
      properties:
        trace:
          type: object
          description: Trace header fields.
        spans:
          type: array
          description: Array of span objects assembled into a tree.
  securitySchemes:
    bearer:
      type: http
      scheme: bearer