Error Handling

Standard HTTP status codes and JSON error responses returned by the Visimade API.

Status Code	Description
200	Success
201	Created (for POST requests)
400	Bad request - invalid parameters or request body
401	Unauthorized - invalid or missing token
403	Forbidden - insufficient permissions or scopes
404	Not found - resource does not exist
429	Too many requests - rate limited
500	Internal server error

{
  "error": "Description of what went wrong",
  "code": "ERROR_CODE"
}

Code	Description
`INVALID_TOKEN`	The API token is invalid, expired, or revoked
`INSUFFICIENT_SCOPE`	The token does not have the required scope for this operation
`UNAUTHORIZED`	No authentication provided
`FORBIDDEN`	Access denied to this resource
`NOT_FOUND`	The requested resource does not exist
`BAD_REQUEST`	Invalid request parameters or body

On this page