Skip to main content
GET
/
namespaces
/
{namespace_name}
/
delete-jobs
/
{job_id}
curl "http://localhost:8080/namespaces/my-documents/delete-jobs/job-682efd0be4484e49b7bf787466d6e9a4"

{
  "job_id": "job-682efd0be4484e49b7bf787466d6e9a4",
  "namespace_name": "my-documents",
  "status": "running",
  "total_items": 42,
  "deleted_items": 0,
  "last_error": null,
  "started_at": "2026-05-21T12:10:00.000Z",
  "updated_at": "2026-05-21T12:10:00.000Z",
  "finished_at": null
}

​
Overview

Returns status for a namespace delete started by Delete namespace.

​
Path parameters

​
namespace_name
string
required
Namespace the delete job belongs to. Must match the namespace used when the job was started.
​
job_id
string
required
Job id returned from the delete response.
curl "http://localhost:8080/namespaces/my-documents/delete-jobs/job-682efd0be4484e49b7bf787466d6e9a4"

​
Response fields

​
job_id
string
Id of the delete job.
​
namespace_name
string
Namespace being deleted.
​
status
string
Job state on success: "running", "completed", or "failed". On lookup errors: "failure".
​
total_items
number
Number of items in the namespace when the delete started.
​
deleted_items
number
Number of items removed so far. Equals total_items when job status is "completed".
​
last_error
string | null
Error message when job status is "failed"; otherwise null.
​
started_at
string
ISO 8601 UTC timestamp when the job started.
​
updated_at
string
ISO 8601 UTC timestamp of the last job update.
​
finished_at
string | null
ISO 8601 UTC timestamp when the job finished; null while the job is "running".
​
message
string
Error description when the job cannot be found.
{
  "job_id": "job-682efd0be4484e49b7bf787466d6e9a4",
  "namespace_name": "my-documents",
  "status": "running",
  "total_items": 42,
  "deleted_items": 0,
  "last_error": null,
  "started_at": "2026-05-21T12:10:00.000Z",
  "updated_at": "2026-05-21T12:10:00.000Z",
  "finished_at": null
}