job/single

Returns one job by id.

Method and path

GET /job/single/{job_id}

Authentication

Authentication is required. See Authentication.

Permissions

Accessible to tier 1 and 2 users.

Admin users can retrieve any job.

Superusers are limited to jobs linked to projects they can access.

Request headers

Header	Required	Description
X-Api-Key or X_API_KEY	yes	API key.

Path parameters

Parameter	Type	Required	Description
job_id	integer	yes	Job identifier.

Example request

curl "$SIGNAL_API_BASE_URL/job/single/<job_id>" \
  -H "X-Api-Key: $SIGNAL_API_KEY"

Example response

{
  "id": "<job_id>",
  "type": "<job_type>",
  "active": "<boolean>",
  "freq": "<frequency_seconds>",
  "label": "Example Job",
  "notes": "Example notes",
  "search": "<search_string_or_json>",
  "search_lang": "<language_code_or_null>",
  "lastrun": "<datetime_or_null>",
  "lastrunTimestamp": "<unix_timestamp_or_null>",
  "timeFromLastRun": "<seconds_or_null>"
}

Response fields

Field	Type	Description
id	integer	Job identifier.
type	string	null
active	boolean	integer
freq	integer	null
label	string	null
notes	string	null
search	string	null
search_lang	string	null
lastrun	string	null
lastrunTimestamp	integer	null
timeFromLastRun	integer	null