GET v1/jobs-queue/{id}

Use this method to retrieve all information for a Job that is presentable to a user. Only settings setup as UI Enabled will be returned by this method.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
id

string

Required

Body Parameters

None.

Response Information

Resource Description

QueueJobModel
NameDescriptionTypeAdditional information
id

Queue UUID

string

None.

entity

Entity

None.

settings

Collection of sys queue items

Collection of QueueJobSetting

None.

type

Queue type

QueueJobType

None.

created

Created date-time

date

None.

updated

Updated date-time

date

None.

status

Status UUID

QueueJobStatus

None.

log

List of entries for each cycle the job has run for.

Collection of QueueJobLogEntry

None.

name

Job Custom display name.

string

None.

schedule

Scheduled date and time when to run this job. If null or in the past, the system will run the job as soon as is picked up by the "System Queue".

date

None.

favorite

Set to true if the job is a favorite job.

boolean

None.

recurrent

Use this property to mark a job as been recurrent. This property will automatically be set to false if interval is not provided or less than 1.

boolean

None.

interval

Recurrence interval used for recurrent jobs in seconds. Recurrence is a hint to the system queue, but ultimately is governed by the cycle interval internal to the system queue. If the system queue cycle interval is set to say one minute. Setting a job interval to less than one minute will simply cause the job to be run on every cycle.

integer

None.

Response Formats

application/json, text/json

Sample:
{
  "id": "sample string 1",
  "entity": {
    "type": 1
  },
  "settings": [
    {
      "id": "sample string 1",
      "name": "sample string 2",
      "value": "sample string 7",
      "label": "sample string 8",
      "extraLabel": "sample string 9",
      "step": 10,
      "isTemplate": true
    },
    {
      "id": "sample string 1",
      "name": "sample string 2",
      "value": "sample string 7",
      "label": "sample string 8",
      "extraLabel": "sample string 9",
      "step": 10,
      "isTemplate": true
    }
  ],
  "type": {
    "id": "sample string 1",
    "platform": 2.1,
    "internalName": "sample string 3",
    "name": "sample string 4",
    "description": "sample string 5",
    "hidden": true,
    "settings": [
      {
        "id": "sample string 1",
        "name": "sample string 2",
        "value": "sample string 7",
        "label": "sample string 8",
        "extraLabel": "sample string 9",
        "step": 10,
        "isTemplate": true
      },
      {
        "id": "sample string 1",
        "name": "sample string 2",
        "value": "sample string 7",
        "label": "sample string 8",
        "extraLabel": "sample string 9",
        "step": 10,
        "isTemplate": true
      }
    ],
    "requiresVenue": true
  },
  "created": "2025-06-26T08:44:28.1761315-07:00",
  "updated": "2025-06-26T08:44:28.1761315-07:00",
  "status": {
    "id": "sample string 1",
    "internalName": "sample string 2",
    "name": "sample string 3"
  },
  "archived": false,
  "log": [
    {
      "status": "sample string 1",
      "date": "2025-06-26T08:44:28.1761315-07:00",
      "log": "sample string 3"
    },
    {
      "status": "sample string 1",
      "date": "2025-06-26T08:44:28.1761315-07:00",
      "log": "sample string 3"
    }
  ],
  "name": "sample string 3",
  "schedule": "2025-06-26T08:44:28.1761315-07:00",
  "favorite": true,
  "recurrent": true,
  "interval": 1
}