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

Authorizations

​
Authorization
string
header
required

Use Authorization: Bearer sk_test_* or Authorization: Bearer sk_live_*.

Path Parameters

​
tenantExternalId
string
required

Your tenant identifier.

Response

Deletion request accepted

​
deletionRequest
object
required