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

# Observability Schema

> Canonical TraceLM observability v2 schema contract

Returns the canonical payload contract for TraceLM observability ingestion.

## Auth

* `Authorization: Bearer <jwt>` or project-scoped `X-API-Key`.

## Response

```json theme={null}
{
  "current_version": "2026-02-23",
  "required_top_level_fields": ["schema_version", "traces"],
  "trace_fields": [
    "trace_id",
    "source_trace_id",
    "root_name",
    "status",
    "environment",
    "session_id",
    "started_at",
    "ended_at",
    "metadata",
    "observations",
    "events",
    "links"
  ],
  "observation_kinds": ["generation", "span", "tool", "retrieval", "event_wrapper"],
  "link_types": ["parent_child", "causal", "retry", "derived_from"],
  "status_values": ["pending", "running", "success", "failed", "timeout", "canceled"]
}
```