Poll Task

Poll a single assessment refresh task until data.attributes.status reaches a terminal state.

Request

Method & Path

GET /assessments/tasks/:id

Path parameters

  • id (uuid, required) โ€” The assessment task ID (from a refresh 202).

Response

  • 200 โ€” The task resource. data.attributes.status is one of queued, running, completed, partial, failed. Terminal tasks also report counts, a per_slug breakdown, and affected_open_dds_versions.
  • 401 / 404 โ€” See Error Codes.

Poll interval_ms and terminal_states come from the refresh response's meta.poll hint. See Refresh semantics.

Required scope: assessments:read