Errors

The CubeStack API uses standard HTTP status codes to indicate success or failure.

Error Response Format

{
  "error": "Error message describing what went wrong"
}

Common Status Codes

Code	Description
`200`	Success
`201`	Created
`400`	Bad Request — Invalid parameters or request body
`401`	Unauthorized — Missing or invalid API key
`403`	Forbidden — Insufficient permissions
`404`	Not Found — Resource does not exist
`409`	Conflict — Duplicate or constraint violation
`429`	Too Many Requests — Rate limit exceeded
`500`	Internal Server Error

Handling Errors

Always check the HTTP status code and parse the error message:

const response = await fetch(url, { headers });

if (!response.ok) {
  const { error } = await response.json();
  console.error(`API Error (${response.status}): ${error}`);
}

See Error Codes for a complete list of error codes.