Errors

{
  "error": "Human-readable error message",
  "code": "machine_readable_code"
}

{
  "error": "Invalid request body",
  "details": [
    {
      "code": "too_small",
      "minimum": 1,
      "type": "string",
      "inclusive": true,
      "exact": false,
      "message": "String must contain at least 1 character(s)",
      "path": ["title"]
    }
  ]
}

{
  "error": "Invalid request body",
  "details": [...]
}

{
  "error": "Invalid or missing API key"
}

{
  "error": "Active subscription required",
  "code": "no_subscription"
}

{
  "error": "Assessment quota exceeded",
  "code": "quota_exceeded",
  "used": 10,
  "quota": 10
}

{
  "error": "Assessment not found"
}

{
  "error": "Session already exists",
  "id": "existing-session-id"
}

{
  "error": "Rate limit exceeded"
}

{
  "error": "Internal server error"
}

import requests

res = requests.get(
    "https://api.promptster.ai/v1/assessments/nonexistent-id",
    headers={"Authorization": f"Bearer {api_key}"},
)

if res.status_code == 401:
    raise Exception("API key is invalid or revoked")
elif res.status_code == 402:
    code = res.json().get("code")
    raise Exception(f"Subscription issue: {code}")
elif res.status_code == 404:
    print("Resource not found")
elif res.status_code == 429:
    reset = res.headers.get("x-ratelimit-reset")
    print(f"Rate limited. Retry after: {reset}")
elif res.status_code >= 500:
    print("Server error, retry with backoff")
elif not res.ok:
    print(f"Error {res.status_code}: {res.json().get('error')}")