Errors
Interpret gospace API error responses.
gospace returns structured error objects with an HTTP status code and machine-readable code.
{
"success": false,
"error": {
"code": "validation_failed",
"message": "payload.horizon must be an ISO 8601 duration",
"details": [
{
"path": "payload.horizon",
"message": "Expected ISO 8601 duration"
}
],
"request_id": "req_01J0X0M7KNG7KQZ4XQY4J6V6P4"
}
}
Common codes
| Code | Description |
|---|---|
unauthorised | Missing or invalid credentials. Refresh your token or verify scopes. |
forbidden | Authenticated but lacking permission for the workspace or resource. |
validation_failed | Request body or query string did not satisfy schema validation. Details array explains the failure. |
resource_not_found | The resource does not exist or is outside the workspace scope. |
rate_limited | Requests exceeded the plan’s quota. Respect Retry-After. |
internal_error | Unexpected server error. Retry with backoff and contact support if persistent. |
Include the request_id when contacting support@gospace.ai.