Skedulo Lens REST API

Skedulo Lens provides a REST API that exposes access to data and scheduling functions. The base URI for all operations is All requests and results to REST calls are encoded in JSON (Content-Type: application/json).

Requests support the following HTTP verbs:

  • GET
  • POST
  • PUT

Results are JSON-encoded and wrapped in the following structure:

  "result": ...

Errors are given as follows:

  "errorType": "bad_request",
  "message": "A Job Id or Job Allocation Id must be supplied"

Skedulo Lens HTTP status codes

The Lens REST API uses the HTTP status code to communicate the success or failure of the request. The following codes are used.

HTTP Status Code Description
200 OK Response to a successful GET, PUT, PATCH or DELETE. Can also be used for a POST that doesn’t result in a creation.
201 Created Response to a POST that results in a creation of a resource. Should append the JSON representation of the resource in the body.
202 Accepted Similar to \“201 Created,\” but this is returned if we CANNOT create the object currently, e.g., When creation of the resource is queued but not processed yet.
400 Bad Request The request is malformed, such as if the body does not parse or a required field is missing.
401 Unauthorized When no or invalid authentication details are provided.
403 Forbidden Authentication succeeded but authenticated user doesn’t have access right to the resource.
404 Not Found When a non-existent endpoint or resource is requested (GET, DELETE etc.)
409 Conflicted When the request cannot be fulfilled due to a conflict with some business logic.
405 Method Not Allowed When an HTTP method is being requested that isn’t allowed for the authenticated user.
410 Gone Indicates that the resource at this end-point is no longer available. Useful as a blanket response for old API versions.
415 Unsupported Media Type If an incorrect content type is provided as part of the request.
429 Too Many Requests When a request is rejected due to rate limiting.