RErender
One-Off Jobs

List jobs

Changed on

List jobs for the provided service that match the provided filters. If no filters are provided, all jobs for the service are returned.

get/services/{serviceId}/jobs

Request

  • Base URL
    https://api.render.com/v1
  • Auth
    HTTP bearer

Query parameters

cursorstring

The position in the result list to start from when fetching paginated results. For details, see Pagination.

limitinteger

Defaults to 20

The maximum number of items to return. For details, see Pagination.

statusstring[]

Filter for the status of the job (pending, running, succeeded, failed, or canceled)

createdBeforestring date-time

Filter for jobs created before a certain time (specified as an ISO 8601 timestamp)

createdAfterstring date-time

Filter for jobs created after a certain time (specified as an ISO 8601 timestamp)

startedBeforestring date-time

Filter for jobs started before a certain time (specified as an ISO 8601 timestamp)

startedAfterstring date-time

Filter for jobs started after a certain time (specified as an ISO 8601 timestamp)

finishedBeforestring date-time

Filter for jobs finished before a certain time (specified as an ISO 8601 timestamp)

finishedAfterstring date-time

Filter for jobs finished after a certain time (specified as an ISO 8601 timestamp)

Response

OK

jobSchema required(unresolved $ref)
cursorstring required

Changes

  • 6ac5d3d47362Revision changes
    • breaking

      the // response's property type changed from no type to string for status

    • breaking

      the // response's property type changed from no type to string for status

    • warning

      added the new canceled enum value to the // response property for the response status

    • warning

      added the new failed enum value to the // response property for the response status

    • warning

      added the new pending enum value to the // response property for the response status

    • warning

      added the new running enum value to the // response property for the response status

    • warning

      added the new succeeded enum value to the // response property for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      the // response's property pattern ^job-[0-9a-z]{20}$ was added for the status