curl -X DELETE 'https://embed.nova.dweet.com/v1/tenants/acme-corp' \
-H 'Authorization: Bearer sk_live_abc123...'
{
"deletionRequest": {
"id": "delreq_abc123",
"scope": "tenant",
"status": "pending",
"createdAt": "2026-05-13T09:00:00.000Z",
"updatedAt": "2026-05-13T09:00:00.000Z",
"completedAt": null,
"failedAt": null
}
}
Deletion
Delete Tenant Data
Request deletion for one tenant
DELETE
/
v1
/
tenants
/
{tenantExternalId}
curl -X DELETE 'https://embed.nova.dweet.com/v1/tenants/acme-corp' \
-H 'Authorization: Bearer sk_live_abc123...'
{
"deletionRequest": {
"id": "delreq_abc123",
"scope": "tenant",
"status": "pending",
"createdAt": "2026-05-13T09:00:00.000Z",
"updatedAt": "2026-05-13T09:00:00.000Z",
"completedAt": null,
"failedAt": null
}
}
Deletes active Nova data scoped to one tenant external ID.
This endpoint requires only a valid API key.
X-Tenant-Id isn’t required because the tenant external ID is in the path.
curl -X DELETE 'https://embed.nova.dweet.com/v1/tenants/acme-corp' \
-H 'Authorization: Bearer sk_live_abc123...'
{
"deletionRequest": {
"id": "delreq_abc123",
"scope": "tenant",
"status": "pending",
"createdAt": "2026-05-13T09:00:00.000Z",
"updatedAt": "2026-05-13T09:00:00.000Z",
"completedAt": null,
"failedAt": null
}
}
Behavior
The endpoint returns202 Accepted with a deletionRequest.id. Deletion runs in the background.
Poll Get Deletion Request Status until the request is completed or failed.
Unknown tenants are accepted without creating a tenant record or revealing whether active data existed.
Deleted data
Tenant deletion removes active scoring data, tenant-scoped criteria and library data, stored resume copies, and delivery records linked to the tenant. It doesn’t close the partner account or remove integration configuration.Was this page helpful?