Mokapen API Documentation

Error Codes

The Mokapen API uses standard HTTP status codes. Error responses are returned as JSON with a descriptive message.

HTTP status codes

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

Authentication errors

  • 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.

Нужна помощь?