Tasks

Tasks represent background operations like backfills and organization deletions. Use these endpoints to monitor progress.

Endpoints

Method	Path	Description
GET	/v1/tasks	List tasks
GET	/v1/tasks/{task_id}	Get a task

---

List Tasks

GET /v1/tasks

Returns active and recent tasks for the current organization.

Auth: API key (any permission)

curl https://api.embedd.to/v1/tasks \
  -H "Authorization: Bearer sk_your_api_key"

Response (200):

{
  "data": [
    {
      "id": "task_abc123",
      "org_id": "org_abc123",
      "task_type": "backfill",
      "target_id": "vt_abc123",
      "status": "running",
      "priority": 3,
      "progress": {
        "last_processed_pk": "42",
        "rows_processed": 500
      },
      "attempts": 1,
      "max_attempts": 3,
      "last_error": null,
      "created_at": "2026-03-13T10:00:00Z"
    }
  ]
}

---

Get a Task

GET /v1/tasks/{task_id}

Auth: API key (any permission)

curl https://api.embedd.to/v1/tasks/task_abc123 \
  -H "Authorization: Bearer sk_your_api_key"

Response (200): Same shape as individual task object above.

Errors:

Status	Reason
404	Task not found

---

Task Types

Type	Description	Triggered By
backfill	Initial vector population	POST /v1/vector-tables/{id}/backfill
rebackfill	Re-embed after config change	PUT /v1/vector-tables/{id} (when columns/model/dimensions change)
org_deletion	Async organization cleanup	DELETE /v1/organizations/{id}

Task Statuses

Status	Meaning
pending	Queued, waiting for a worker
running	Currently being processed
completed	Finished successfully
failed	Failed after max attempts (see last_error)

Task Priority

Lower numbers run first. Default priorities:

Task Type	Priority
backfill	3
rebackfill	3
org_deletion	7