discovery-runs

Get a discovery job

Changed on

Return the current status and progress of a discovery pipeline job.

Use this discovery operation to create, synchronize, lease, inspect, or cancel research work. Treat discovered actors as reviewable leads until their source evidence and visibility state are checked.

get/api/discovery-runs/jobs/{job_id}

Request

  • Base URL: https://atlas.rebuildingus.org
  • URL: https://atlas.rebuildingus.org/api/discovery-runs/jobs/{job_id}
  • Auth: none declared

Path parameters

job_idstring required

Headers

x-api-keystring nullable

Response

Successful Response

completed_atstring nullable

Completion timestamp

created_atstring required

Creation timestamp

error_messagestring nullable

Error message if failed

execution_mode'search' | 'direct_url'

How a Scout worker should execute this job

idstring required

Job ID

input_payloadobject

Mode-specific worker input payload

max_retriesinteger

Maximum retry attempts before permanent failure

progressobject nullable

Current step and metrics

retry_countinteger

Number of retry attempts so far

run_idstring required

Associated discovery run ID

started_atstring nullable

Execution start timestamp

statusstring required

Job status (queued, claimed, running, completed, failed)

Changes

  • 6ea72ce93d40Revision changes
    • warning

      deleted the header request parameter x-atlas-actor-email

    • warning

      deleted the header request parameter x-atlas-actor-id

    • warning

      deleted the header request parameter x-atlas-internal-secret

    • warning

      deleted the header request parameter x-atlas-organization-id