Memory API
Errors
A JSON body with a single error field. Match on the status and the message.
| Response | When |
|---|---|
| 401Unauthorized | Missing, malformed, or expired token. |
| 400Content is required. | POST /ingest with empty or whitespace-only content. |
| 400Query is required. | POST /recall or /answer with an empty query. |
| 400Group must be at most 200 characters. | The group key exceeds the ledger column width. |
| 400Not a member of the requested team. | The passed teamId is not one the token can reach. |
| 400The user belongs to no team. | The token resolves to no project. This should not happen on a provisioned key; email us if it does. |
| 400responseSchema is only supported in pipeline mode. | responseSchema sent together with mode: "agent". |
| 400Content must be at most 2000000 characters. | One data point is capped at two million characters. A whole transcript fits; a pasted corpus does not. |
| 400Label must be at most 2000 characters. | The label is a descriptor, not content. |
| 400Id must be at most 500 characters. | The source id is a key, not content. |
| 400Query must be at most 20000 characters. | A query longer than this is a pasted document rather than a question. |
| 400Group is required. | PUT /ingest/group without a group key. |
| 400Every item needs content. | PUT /ingest/group with an item whose content is empty. |
| 400The user belongs to several teams — pass teamId (the team's hash). | The token reaches more than one project and no teamId was passed. |
There are no stable error codes yet. Versioned routes and a frozen error contract are both on the roadmap below.