Tasks

Track the lifecycle of ingestion tasks. Each file upload creates a task that progresses through validation, geocoding, and location matching stages.

Use cases

  • Progress monitoring โ€” poll task status to know when an upload has finished processing
  • Audit trail โ€” list historical ingestion tasks to review what data was uploaded and when
  • Summary reporting โ€” retrieve task summaries showing success/failure counts and error breakdowns
  • Housekeeping โ€” relabel a task once you know what it turned out to contain

Endpoints

MethodPathDescription
GET/ingestion/tasksList all ingestion tasks with filtering and pagination
GET/ingestion/tasks/:idGet the status and details of a specific task
GET/ingestion/tasks/:id/summaryGet result counts and error details for a task
PATCH/ingestions/:idUpdate a task's name and/or description (requires ingestions:write)

Task lifecycle

StatusDescription
pendingTask created, processing has not started
processingFile is being validated, geocoded, and matched
completedAll rows processed successfully
completed_with_errorsSome rows succeeded, some failed
failedAll rows failed or the task timed out

Required scope: ingestion:read