Skip to main content

​
Base URL

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