Every error returned by the ComputeSphere API now ships with a stable code and a direct link to its catalog entry — paste the URL into Claude, Cursor, or ChatGPT and they have full context for debugging.
The envelope
Every error response carries the same shape:
{
"type": "https://docs.computesphere.com/errors/trial_expired",
"code": "trial_expired",
"title": "Trial period ended",
"status": 402,
"detail": "Your 14-day trial has ended and no active subscription is on file.",
"request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
}
Switch on code in your client — title and detail may evolve as we improve copy, code will not.
The catalog
The full catalog lives at /errors. Each entry includes plain-English explanation, action-led fix steps, retry guidance, and code samples in TypeScript, Python, Go, and curl.
You can jump straight to any error page by appending the code: https://docs.computesphere.com/errors/<CODE>.
Why this matters
When something fails at 2 AM, the difference between "an opaque HTTP 500" and "a page that names the cause and shows the fix" is the difference between staying online and waiting on support.