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

# Deletion Requests

> Delete application or tenant data through the Nova Embed API

Use deletion requests when a customer leaves, a tenant asks you to remove its data, or one application needs to be removed before automatic cleanup runs.

Deletion runs asynchronously. Nova returns a `deletionRequest.id` immediately, then processes the request in the background.

## Endpoints

| Action                 | Endpoint                                               | Scope                                   |
| ---------------------- | ------------------------------------------------------ | --------------------------------------- |
| Delete one application | `DELETE /v1/jobs/{jobId}/applications/{applicationId}` | Requires `X-Tenant-Id`                  |
| Delete one tenant      | `DELETE /v1/tenants/{tenantExternalId}`                | Uses the tenant external ID in the path |
| Poll status            | `GET /v1/deletion-requests/{deletionRequestId}`        | Uses the deletion request ID            |

## Flow

<Steps>
  <Step title="Submit the deletion request">
    Call the application or tenant deletion endpoint. Store the returned `deletionRequest.id`.
  </Step>

  <Step title="Poll the request">
    Call `GET /v1/deletion-requests/{deletionRequestId}` until the status is `completed` or `failed`.
  </Step>

  <Step title="Handle retries">
    Retrying the same active application or tenant deletion request returns the existing request where possible.
  </Step>
</Steps>

## Status values

| Status       | Meaning                        |
| ------------ | ------------------------------ |
| `pending`    | Nova accepted the request      |
| `processing` | Background deletion is running |
| `completed`  | Nova processed the request     |
| `failed`     | The request failed             |

## Scope

Nova scopes every deletion by the authenticated API key and environment.

Application deletion removes active data linked to the specified tenant, job, and application. Tenant deletion removes active tenant-scoped Embed data.

Deletion status responses don't expose internal cleanup counts, storage details, raw tenant IDs, job IDs, or application IDs. Keep the `deletionRequest.id` if you need to discuss a request with Nova support.

See [Data Retention](/embed-api/concepts/data-retention) for retention windows, backups, logs, and sub-processors.