> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moorcheh.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Namespace Delete Job Status

> Poll progress of an asynchronous namespace delete job.

## Overview

Returns status for a namespace delete started by [Delete namespace](/on-prem/api-references/namespaces/delete).

## Path parameters

<ParamField path="namespace_name" type="string" required>
  Namespace the delete job belongs to. Must match the namespace used when the job was started.
</ParamField>

<ParamField path="job_id" type="string" required>
  Job id returned from the delete response.
</ParamField>

<RequestExample>
  ```bash theme={null}
  curl "http://localhost:8080/namespaces/my-documents/delete-jobs/job-682efd0be4484e49b7bf787466d6e9a4"
  ```
</RequestExample>

## Response fields

<ResponseField name="job_id" type="string">
  Id of the delete job.
</ResponseField>

<ResponseField name="namespace_name" type="string">
  Namespace being deleted.
</ResponseField>

<ResponseField name="status" type="string">
  Job state on success: `"running"`, `"completed"`, or `"failed"`. On lookup errors: `"failure"`.
</ResponseField>

<ResponseField name="total_items" type="number">
  Number of items in the namespace when the delete started.
</ResponseField>

<ResponseField name="deleted_items" type="number">
  Number of items removed so far. Equals `total_items` when job `status` is `"completed"`.
</ResponseField>

<ResponseField name="last_error" type="string | null">
  Error message when job `status` is `"failed"`; otherwise `null`.
</ResponseField>

<ResponseField name="started_at" type="string">
  ISO 8601 UTC timestamp when the job started.
</ResponseField>

<ResponseField name="updated_at" type="string">
  ISO 8601 UTC timestamp of the last job update.
</ResponseField>

<ResponseField name="finished_at" type="string | null">
  ISO 8601 UTC timestamp when the job finished; `null` while the job is `"running"`.
</ResponseField>

<ResponseField name="message" type="string">
  Error description when the job cannot be found.
</ResponseField>

<ResponseExample>
  ```json 200 - Running theme={null}
  {
    "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
  }
  ```

  ```json 200 - Completed theme={null}
  {
    "job_id": "job-682efd0be4484e49b7bf787466d6e9a4",
    "namespace_name": "my-documents",
    "status": "completed",
    "total_items": 42,
    "deleted_items": 42,
    "last_error": null,
    "started_at": "2026-05-21T12:10:00.000Z",
    "updated_at": "2026-05-21T12:10:05.000Z",
    "finished_at": "2026-05-21T12:10:05.000Z"
  }
  ```

  ```json 200 - Failed theme={null}
  {
    "job_id": "job-682efd0be4484e49b7bf787466d6e9a4",
    "namespace_name": "my-documents",
    "status": "failed",
    "total_items": 42,
    "deleted_items": 0,
    "last_error": "Internal error while deleting namespace.",
    "started_at": "2026-05-21T12:10:00.000Z",
    "updated_at": "2026-05-21T12:10:02.000Z",
    "finished_at": "2026-05-21T12:10:02.000Z"
  }
  ```

  ```json 404 - Job Not Found theme={null}
  {
    "status": "failure",
    "message": "Delete job not found."
  }
  ```

  ```json 404 - Wrong Namespace theme={null}
  {
    "status": "failure",
    "message": "Delete job not found for namespace."
  }
  ```
</ResponseExample>

## Related

* [Delete namespace](/on-prem/api-references/namespaces/delete)
* [CLI: moorcheh namespace-delete-job-status](/on-prem/cli/namespaces/delete-job-status)
* [Python: namespaces.delete\_job\_status()](/on-prem/python-client/namespaces/delete-job-status)