Error codes

The following error codes are used by the Scheduler API

Each time an error occurs it will be indicated both by a numeric http status code returned with the response, and by a textual status within the response.

The error codes returned by the Scheduler API are as follows:

Error codes

Value

Text

Meaning

200

OK

The request completed successfully

201

Created

The item requested was created

400

Bad request

The request did not make enough sense to be processed

401

Access denied

The client has not yet authenticated as a suitable user

403

Forbidden

The client has authenticated, but does not have permission to perform the requested action

404

Not found

The item requested could not be found

405

Method not allowed

The client has requested an action which isn’t consistent. E.g. to create a Request record for something which doesn’t have requests.

418

I’m a teapot

Self explanatory

422

Unprocessable entity

The parameters given on an action make it impossible to complete. E.g. the parameters to create an event are incomplete or inconsistent. See the JSON response for more details of exactly what is wrong.

503

Service unavailable

The API is unable to handle the creation of an event, probably because the appropriate eventsource does not exist in the system.