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
| Method | Path | Description |
|---|---|---|
| GET | /ingestion/tasks | List all ingestion tasks with filtering and pagination |
| GET | /ingestion/tasks/:id | Get the status and details of a specific task |
| GET | /ingestion/tasks/:id/summary | Get result counts and error details for a task |
| PATCH | /ingestions/:id | Update a task's name and/or description (requires ingestions:write) |
โถTask lifecycle
| Status | Description |
|---|---|
pending | Task created, processing has not started |
processing | File is being validated, geocoded, and matched |
completed | All rows processed successfully |
completed_with_errors | Some rows succeeded, some failed |
failed | All rows failed or the task timed out |
Required scope:
ingestion:read