Skip to main content
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

​
Flow

1

Submit the deletion request

Call the application or tenant deletion endpoint. Store the returned deletionRequest.id.
2

Poll the request

Call GET /v1/deletion-requests/{deletionRequestId} until the status is completed or failed.
3

Handle retries

Retrying the same active application or tenant deletion request returns the existing request where possible.

​
Status values

​
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 for retention windows, backups, logs, and sub-processors.