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

# Troubleshooting

> Common integration issues and fixes

## 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`)

2. Confirm base URL:

* Production: `https://api.tracelm.ai`
* Local: `http://localhost:8000`

3. 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.)