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

# Errors

> Common API and ingestion errors

Most Agnost API errors return a JSON body with an `error` string:

```json theme={null}
{
  "error": "Invalid request body"
}
```

## Common errors

| Symptom                  | Likely cause                                               | Fix                                                                                                                   |
| ------------------------ | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| No events appear         | Wrong org ID or endpoint                                   | Confirm org ID in Settings -> Organization and use `https://api.agnost.ai` or `https://otel.agnost.ai/v1/traces`.     |
| 401/403 on dashboard API | Missing JWT/API key or wrong org scope                     | Use `Authorization: Bearer <jwt>` or `x-api-key` plus the right `x-org-id`.                                           |
| 400 on ingestion         | Missing required field or invalid UUID                     | Validate `session_id`, `event_id`, and `user_data.user_id`.                                                           |
| OTel traces missing      | Header not attached or exporter endpoint is wrong          | Set `OTEL_EXPORTER_OTLP_HEADERS=X-Agnost-Org-ID=<your-org-id>` and use `/v1/traces` when the SDK expects a trace URL. |
| Tool inputs missing      | Input capture disabled or framework did not export content | Check SDK config and framework telemetry settings.                                                                    |

## Debugging checklist

1. Send one test event.
2. Open **Raw logs** in the Agnost dashboard.
3. Confirm the event has the expected org ID, user ID, session/conversation ID, and agent/tool name.
4. Check **Tools** or **Conversations** depending on the integration.
5. If using OpenTelemetry, confirm your app can reach `otel.agnost.ai`.

## Related pages

* [Authentication](/authentication)
* [Quickstart troubleshooting](/quickstart#troubleshooting)
* [Data Governance](/data-governance)