Error codes
Every code a Medos Developer API problem document can carry. Each one is the page its type URI points at.
| Status | Code | Meaning | Retry? |
|---|---|---|---|
401 | UNAUTHENTICATED | The key was not accepted. | No |
403 | IP_NOT_ALLOWED | The calling address is not on the key's allowlist. | No |
403 | ROUTE_NOT_AVAILABLE | The path is not one of the Developer API's seventeen routes. | No |
403 | FEATURE_NOT_ENTITLED | The workspace's plan does not include this route. | No |
400 | INVALID_ACTING_USER | X-Acting-User-Id is not an MDU_… staff id. | No |
403 | ACTING_USER_NOT_A_MEMBER | The acting user is not an active member of this workspace. | No |
400 | END_USER_REQUIRED | Not returned by any Developer API route. | No |
400 | VALIDATION_FAILED | The request body failed validation. | No |
400 | UNKNOWN_FIELD | A parameter or body field the route does not accept. | No |
400 | INVALID_PARAMETER | A value is malformed, out of range, or names something this workspace does not have. | No |
404 | NOT_FOUND | No such record in this workspace, or a /v2 path. | No |
409 | CONFLICT | The write conflicts with an existing record. | After re-reading |
405 | METHOD_NOT_ALLOWED | The path exists, but not with this method. | No |
415 | UNSUPPORTED_MEDIA_TYPE | The request body is not JSON. | No |
406 | NOT_ACCEPTABLE | The Accept header allows nothing this API produces. | No |
429 | RATE_LIMITED | Over a rate limit. | Yes |
4xx | UPSTREAM_REJECTED | The Medos core refused the request. | No |
502 | UPSTREAM_UNAVAILABLE | The Medos core failed or did not answer. | Yes |
500 | INTERNAL_ERROR | Our fault. | Yes |
How the problem document is shaped, and how to handle each family of errors: Developer API errors.