Sitecore API catalog
/
Jobs API
/
Jobs
/
Retrieve a job

Jobs API (v2.0)

Use the Jobs API to retrieve, create, update, and delete job targets or the job description. This REST API lets you interact with:

  • M.Target entities, which are targets of a job.
  • The M.JobDescription entity, which contains information about what to do and what is in progress.

Note
To help you switch to the Jobs API, we provide guidance on how to update calls in your code.

Authentication

To use the Try it feature of the Jobs API, you need:

Download OpenAPI description
index.json
index.yaml
Overview
License closed source
Languages
Servers
https://{server}/

Jobs

The Jobs endpoint is used to retrieve a specific job.

Operations

Retrieve a job

Request

Retrieves a job with a specified ID. Job targets are not retrieved. Only the link to the relation is used. You can get the job ID in the Job details or in the URL when you click a job target on the Processing page (for example, https://contenthub-server.cloud/en-us/user/myjobs/Job/39309 ).

Path
idinteger(int64)required

The ID for the job, for example, 39596.

Query
culturesArray of strings

A culture consists of a two-letter language code and a two-letter region code. For example, the culture code for American English is en-US and for British English isen-GB. This example https://content-hub-server/api/jobs/39596?cultures=en-US. retrieves the job with an ID of 39596 and a culture code of en-US.

curl -i -X GET \
  'https://your-server/api/v2/jobs/{id}?cultures=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Successful operation.

Bodyapplication/json
idinteger(int64)

The ID for the entity, for example 39752.

identifierstring or null

The identifier for the entity. It must be alphanumeric, and can contain periods, underscores, and hyphens, but not spaces or other special characters. For example, nYrCIN0aQxCqY4qbHbwAlg.

culturesArray of strings or null

The cultures associated with the entity, for example en-US.

propertiesobject or null

The properties of the entity.

relationsobject or null

The relations of the entity.

created_byobject(Link)

A link to the user who created this job.

created_onstring(date-time)

The date and time when the entity was created.

modified_byobject(Link)

A link to the user who created this job.

modified_onstring(date-time)

The date and time when the entity was last modified.

locked_byobject(Link)

A link to the user who created this job.

locked_onstring or null(date-time)

The date and time when the entity was locked.

entitydefinitionobject(Link)

A link to the user who created this job.

copyobject(Link)

A link to the user who created this job.

copyasyncobject(Link)

A link to the user who created this job.

permissionsobject(Link)

A link to the user who created this job.

requested_permissionsobject or null

The requested permissions with identification if a certain user has the permission.

lifecycleobject(Link)

A link to the user who created this job.

saved_selectionsobject(Link)

A link to the user who created this job.

rolesobject(Link)

A link to the user who created this job.

annotationsobject(Link)

A link to the user who created this job.

is_root_taxonomy_itemboolean or null

Gets or sets a value indicating whether the entity is a root taxonomy item.

is_path_rootboolean or null

Gets or sets a value indicating whether the entity is a path root.

inherits_securityboolean

Gets or sets a value indicating whether the entity inherits security.

is_system_ownedboolean

Gets or sets a value indicating whether the entity is system owned.

versioninteger(int64)

The version of the entity.

fullobject(Link)

A link to the user who created this job.

modulesArray of strings or null

The modules associated with the entity.

selfobject(Link)

A link to the user who created this job.

property name*anyadditional property
Response
application/json
{
  "id": 0,
  "identifier": "string",
  "cultures": [
    "string"
  ],
  "properties": {
    "property1": {},
    "property2": {}
  },
  "relations": {
    "property1": {},
    "property2": {}
  },
  "created_by": {
    "href": "string",
    "filename_properties": [ … ],
    "title": "string",
    "templated": false
  },
  "created_on": "2019-08-24T14:15:22Z",
  "modified_by": {
    "href": "string",
    "filename_properties": [ … ],
    "title": "string",
    "templated": false
  },
  "modified_on": "2019-08-24T14:15:22Z",
  "locked_by": {
    "href": "string",
    "filename_properties": [ … ],
    "title": "string",
    "templated": false
  },
  "locked_on": "2019-08-24T14:15:22Z",
  "entitydefinition": {
    "href": "string",
    "filename_properties": [ … ],
    "title": "string",
    "templated": false
  },
  "copy": {
    "href": "string",
    "filename_properties": [ … ],
    "title": "string",
    "templated": false
  },
  "copyasync": {
    "href": "string",
    "filename_properties": [ … ],
    "title": "string",
    "templated": false
  },
  "permissions": {
    "href": "string",
    "filename_properties": [ … ],
    "title": "string",
    "templated": false
  },
  "requested_permissions": {
    "property1": true,
    "property2": true
  },
  "lifecycle": {
    "href": "string",
    "filename_properties": [ … ],
    "title": "string",
    "templated": false
  },
  "saved_selections": {
    "href": "string",
    "filename_properties": [ … ],
    "title": "string",
    "templated": false
  },
  "roles": {
    "href": "string",
    "filename_properties": [ … ],
    "title": "string",
    "templated": false
  },
  "annotations": {
    "href": "string",
    "filename_properties": [ … ],
    "title": "string",
    "templated": false
  },
  "is_root_taxonomy_item": true,
  "is_path_root": true,
  "inherits_security": true,
  "is_system_owned": true,
  "version": 0,
  "full": {
    "href": "string",
    "filename_properties": [ … ],
    "title": "string",
    "templated": false
  },
  "modules": [
    "string"
  ],
  "self": {
    "href": "string",
    "filename_properties": [ … ],
    "title": "string",
    "templated": false
  },
  "property1": null,
  "property2": null
}

Job description

The Jobs description entity contains information for the worker about what needs to be done and what is in progress.

Operations

Targets

A target entity is a target of a job (meaning a background processes). Each job can have one or more targets.

Operations