Skip to main content

​
Error codes

CodeHTTP statusTypeDefault message
invalid_request400invalid_request_errorThe request body is malformed or not valid.
api_error400api_errorInternal or third-party API error.
invalid_token401invalid_request_errorInvalid token.
forbidden403invalid_request_errorYou do not have permission to access this resource. Please contact our support team if you believe you should have access.
resource_not_found404invalid_request_errorThe requested resource was not found.
invalid_endpoint404invalid_request_errorThe requested endpoint does not exist.
invalid_format406invalid_request_errorThe request ACCEPT header is not valid or supported.
conflict409invalid_request_errorThe resource cannot be deleted or modified due to existing dependencies or business constraints.
invalid_url_param422invalid_request_errorThe request URL param is invalid.
invalid_content422invalid_request_errorThe request body content is not valid.
too_many_requests429invalid_request_errorRate Limit Exceeded. You have reached the maximum number of requests. Please try again later.
internal_server_error500api_errorUnexpected internal error.

​
Example response

{
  "error": {
    "code": "invalid_content",
    "details": [
      {
        "message": "value at `/email` does not match format: email",
        "pointer": "/email"
      }
    ],
    "links": [
      {
        "kind": "open_api",
        "name": "OpenAPI specification",
        "url": "https://public-api.stora.co/2025-09/openapi.json"
      },
      {
        "kind": "documentation",
        "name": "Errors",
        "url": "https://docs.stora.co/public-api#overview--errors"
      }
    ],
    "message": "The request body content is not valid.",
    "request_id": "01563646-58c1-4607-8fe0-cae3e92c4477",
    "type": "invalid_request_error"
  }
}

​
Troubleshooting

  • 401 Unauthorized — Check that your access token is valid and hasn’t expired. Regenerate it if needed.
  • 403 Forbidden — Your token doesn’t have the required scope for this endpoint. Check the authorization scopes.
  • 422 Invalid content — The request body doesn’t match the expected schema. Check the details array in the error response for specific field-level errors.
  • 429 Too Many Requests — You’ve hit the rate limit. See rate limiting for how to handle this.