Skip to main content

Error Format

All errors return JSON:
Or for validation errors:

Common Errors

400 Bad Request

Missing required fields:
Solution: Check your request and include all required fields. Duplicate username:
Solution: Use a different username or let it auto-generate.

401 Unauthorized

Missing token:
Solution: Include Authorization: Bearer YOUR_TOKEN header. Expired token:
Solution: Use your refresh token to get a new access token.

403 Forbidden

Insufficient permissions:
Solution: Only admin users can create, update, or delete. Use an admin account.

404 Not Found

Resource not found:
Solution: Check the ID exists and belongs to your organization.

Example Error Handling

HTTP Status Codes