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

# API Reference

> Current TraceLM API contracts for tracing and reliability analysis

## Base URL

```text theme={null}
https://api.tracelm.ai
```

## Authentication

TraceLM supports two auth modes, depending on endpoint type:

* Proxy/SDK traffic: `X-API-Key` + provider `Authorization: Bearer <provider_key>`
* Product APIs (dashboard/user-scoped): `Authorization: Bearer <jwt>`
* Some task/conversation endpoints accept either API key or JWT.

See `/api-reference/authentication` for setup details and examples.

## Core Endpoints

### Proxy

* `POST /v1/chat/completions`
* `POST /v1/completions` (legacy)

### Tasks

* `GET /api/v1/tasks`
* `GET /api/v1/tasks/{task_id}`
* `GET /api/v1/tasks/{task_id}/tool-calls`
* `GET /api/v1/tasks/{task_id}/loops`
* `GET /api/v1/tasks/{task_id}/timeline`
* `POST /api/v1/tasks/{task_id}/detect`
* `PUT /api/v1/tasks/{task_id}/complete`
* `PUT /api/v1/tasks/{task_id}/fail`

### Conversations

* `GET /api/v1/conversations`
* `GET /api/v1/conversations/{conversation_id}`
* `GET /api/v1/conversations/{conversation_id}/context-failures`
* `GET /api/v1/conversations/{conversation_id}/context-health`
* `GET /api/v1/conversations/{conversation_id}/trace-tree`
* `GET /api/v1/conversations/{conversation_id}/traces`

### Feedback and Alerts

* `POST /api/v1/tasks/{task_id}/feedback`
* `GET /api/v1/tasks/{task_id}/feedback`
* `GET /api/v1/feedback/patterns`
* `GET /api/v1/feedback/stats`
* `GET /api/v1/alerts/rules`
* `GET /api/v1/alerts/summary`
* `GET /api/v1/alerts/high-risk`
* `GET /api/v1/alerts/stats`

### Onboarding Telemetry

* `POST /api/v1/onboarding/events`
* `GET /api/v1/onboarding/funnel`
* `GET /api/v1/onboarding/report`
* `POST /api/v1/onboarding/seeded-reliability-scenario`

### Verification

* `POST /api/v1/verification/traces/{trace_id}/verify`
* `GET /api/v1/verification/traces/{trace_id}`
* `GET /api/v1/verification/traces/{trace_id}/summary`
* `GET /api/v1/verification/traces/{trace_id}/claims`
* `GET /api/v1/verification/config`

### Observability v2

* `GET /api/v2/observability/schema`
* `GET /api/v2/observability/schema/versions`
* `POST /api/v2/observability/ingest`
* `GET /api/v2/observability/ingest/{ingest_request_id}`
* `GET|PUT /api/v2/observability/retention-policy`
* `POST /api/v2/observability/archive/run`
* `POST /api/v2/observability/restore`
* `GET|PUT /api/v2/observability/store-routing`
* `POST /api/v2/observability/store-benchmark/run`
* `POST /api/v2/observability/query`
* `POST /api/v2/observability/query/aggregate`
* `POST /api/v2/observability/query/explain`
* `POST /api/v2/observability/saved-queries`
* `GET /api/v2/observability/saved-queries`
* `DELETE /api/v2/observability/saved-queries/{saved_query_id}`
* `GET /api/v2/observability/query/route-stats`
* `GET /api/v2/observability/store-selection/scorecard`
* `GET /api/v2/observability/traces/{trace_id}/explorer`
* `GET /api/v2/observability/traces/{trace_id}/critical-path`
* `GET /api/v2/observability/traces/{trace_id}/events`
* `POST /api/v2/observability/correlations`
* `GET /api/v2/observability/traces/{trace_id}/correlations`
* `GET /api/v2/observability/correlations/search`
* `POST /api/v2/observability/incidents/rules`
* `GET /api/v2/observability/incidents`
* `POST /api/v2/observability/incidents/{id}/ack`
* `POST /api/v2/observability/incidents/{id}/resolve`
* `POST /api/v2/observability/incidents/{id}/reopen`
* `POST /api/v2/observability/incidents/{id}/assign`
* `POST /api/v2/observability/incidents/suppressions`

### Access Control (Phase 8)

* `GET|POST /api/v2/access/organizations`
* `GET|POST /api/v2/access/organizations/{organization_id}/members`
* `GET /api/v2/access/projects/{project_id}/members`
* `PUT /api/v2/access/projects/{project_id}/members/{member_user_id}`
* `POST /api/v2/access/projects/{project_id}/api-keys/{api_key_id}/scopes`
* `GET|POST /api/v2/access/service-accounts`
* `POST /api/v2/access/service-accounts/{service_account_id}/keys`

### Audit (Phase 8)

* `GET /api/v2/audit/events`

### Reliability Certification (Phase 10)

* `GET /api/v1/reliability/phase10/benchmark-policy`
* `POST /api/v1/reliability/phase10/release-certification`