Skip to main content
GET
Get a source job

Authorizations

Authorization
string
header
required

JWT authentication token

Path Parameters

job_id
string<uuid>
required

Job id returned by a source action

Response

The job

A background analysis, test or synchronization job of a source.

attempt
integer
required

Number of attempts started so far.

configuration_version
integer
required

Configuration version of the source when the job was created.

counters
object
required

Bounded counters (pages, records, upserted, bytes).

created_at
string<date-time>
required
id
string<uuid>
required
kind
enum<string>
required

What the job does. analyze, test, initial_sync, scheduled_sync and manual_sync are custom API source jobs; auto_triage is a run of the source's auto triage rule (any source kind); builtin_refresh reads the first page of a HackerOne or Security Inbox source so reports nobody listed reach the queue; remap (a custom API source job) re-maps the stored provider records of every finding under the current mapping, without fetching.

Available options:
analyze,
test,
initial_sync,
scheduled_sync,
manual_sync,
auto_triage,
builtin_refresh,
remap
source_id
string<uuid>
required
status
enum<string>
required

queued, then running, then succeeded, failed or cancelled.

Available options:
queued,
running,
succeeded,
failed,
cancelled
error_code
string

Stable failure code, such as queue_unavailable, upstream_status or triage_task_limit_reached (an auto triage job that stopped at the team's triage task limit). triage_disabled marks work skipped while Triage is not enabled for the account.

finished_at
string<date-time>
setup
object

Analyze and test jobs with the source-setup agent on: the steps of the run so far (at most 40, oldest first).

started_at
string<date-time>