The Mokapen API uses standard HTTP status codes. Error responses are returned as JSON with a descriptive message.
| Code | Meaning | Common causes |
|---|---|---|
| 400 | Bad Request | Invalid or missing request parameters |
| 401 | Unauthorized | Missing or invalid Bearer token |
| 403 | Forbidden | Insufficient scope, role, or token not authorized for this organization |
| 404 | Not Found | Resource or endpoint does not exist |
| 429 | Too Many Requests | Per-minute throttle exceeded or daily quota reached |
| 500 | Internal Server Error | Unexpected server error — retry with backoff |
Unauthenticated: No Token Provided — no Authorization: Bearer header was sent.Invalid Token — token is malformed, expired, or revoked.This token is not authorized for this organization. — URL {org_id} does not match the token organization.Missing required scopes — token does not include the scope required by the endpoint.Potrzebujesz pomocy?