Skip to main content

​
Traces Not Appearing

  1. Confirm key formats:
  • TraceLM key starts with lt_
  • Provider key is valid (OPENAI_API_KEY, ANTHROPIC_API_KEY, or GOOGLE_API_KEY)
  1. Confirm base URL:
  • Production: https://api.tracelm.ai
  • Local: http://localhost:8000
  1. Confirm proxy request headers:
  • X-API-Key
  • Authorization: Bearer <provider_key>
  • Optional X-Provider
These three checks resolve most first-run integration issues.

​
Task Detection Missing

  • Ensure calls are grouped with X-Task-ID (or SDK task context).
  • Run PUT /api/v1/tasks/{task_id}/complete?run_detection=true or POST /api/v1/tasks/{task_id}/detect.

​
Wrong Task/Conversation Metrics

  • Verify X-Task-ID is stable during one execution cycle.
  • Verify X-Conversation-ID is stable across turns.
  • Use /api/v1/tasks/{task_id}/timeline to debug missing/ordering issues.

​
Feedback Not Updating Patterns

  • Submit feedback with POST /api/v1/tasks/{task_id}/feedback.
  • Check aggregates with /api/v1/feedback/patterns and /api/v1/feedback/stats.
  • Patterns require valid tool_call_id tied to the given task.

​
Verification Route Errors

Use current routes:
  • POST /api/v1/verification/traces/{trace_id}/verify
  • GET /api/v1/verification/traces/{trace_id}
(Older /verification/verify/... and /verification/results/... paths are deprecated.)