Guides
Errors
Error codes returned by the public Connect API.
Error responses use a JSON object with an error code:
Some errors include extra fields, such as filter_cost_exceeded.
| HTTP status | Code | Meaning | Action |
|---|---|---|---|
| 400 | invalid_request | Query parameters or request shape failed validation. | Check the API reference and retry with valid parameters. |
| 400 | invalid_filters | The SSE filters value is not valid URL-encoded JSON or does not match the filter schema. | Encode a JSON array of filter entries. Include sessionId for transcript.segment.created. |
| 400 | filter_cost_exceeded | The SSE filters are valid but exceed the cost budget. | Reduce the number of entries or split subscriptions. |
| 401 | unauthorized | Bearer token is missing, invalid, expired, lacks workspace_id, or the API key is invalid. | Send a valid OAuth token or torqee_ API key. |
| 403 | forbidden | The issuer is no longer an active member of the workspace. | Reauthorize or restore workspace membership. |
| 403 | insufficient_scope | The credential does not include the scope required by the endpoint, event type, or MCP tool. | Request or issue a credential with the required read scope. |
| 404 | not_found | The requested session or board content does not exist. | Verify the resource ID belongs to the credential workspace. |
| 404 | workspace_not_found | Connect could not resolve the tenant database for the credential workspace. | Check workspace provisioning and contact torqee support if it persists. |
| 429 | connection_limit | The workspace has too many concurrent SSE streams. | Close unused streams and reconnect with backoff. |
| 500 | internal_server_error | An unexpected server error occurred. | Retry later; internal details are not exposed in the response. |