---
title: Errors
description: Error codes returned by the public Connect API.
---

Error responses use a JSON object with an `error` code:

```json
{ "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.          |