Errors
Error codes returned by the public Connect API.
Error responses use a JSON object with an error code:
{ "error": "unauthorized" }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. |
| 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 | provider_output_not_found |
The transcript exists but has no stored provider output (for example, recordings transcribed before this feature or by a provider that does not return one). | Treat the transcript as having no provider output; do not retry. |
| 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. |