Middesk uses standard HTTP response codes to indicate the success or failure of an API request.

As a rule of thumb, Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error in the provided information (e.g., a required parameter was omitted, a validation error has occurred, etc.). Codes in the 5xx range indicate an error with Middesk servers.

Some 4xx errors will include a brief explanation of the error in the response body.

Status Code

Meaning

200

OK - Everything worked as expected.

201

The object was created.

202

The request was accepted.

400

Bad Request - The request was unacceptable.

401

Unauthorized - An invalid API key was provided.

404

Not Found - The requested resource does not exist.

422

Validation - A parameter was not formatted correctly.

500

Internal Server Error - We had a problem with our server.