v28

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-07-082940159.9 KB
Tenant Data

Delete tenant data

Permanently deletes Hub-owned data for the specified tenant_id. This endpoint is intended for tenant/account offboarding after the tenant has been deprovisioned and upstream writes for that tenant have stopped. This includes feedback records, derived embeddings, taxonomy data, and webhooks for the tenant. This operation is synchronous and idempotent; repeated calls return zero counts after the tenant data has already been deleted.

The purge is serialized against tenant-owned writes: while it runs, Hub-owned writes for the same tenant_id are rejected with HTTP 409 (code tenant_write_conflict); writes for other tenants are unaffected. If tenant-owned writes are in flight when the purge starts, the purge waits up to a configured lock timeout for them to drain and then returns a retryable 409.

No webhook events are published as part of this purge operation, and writes rejected during the purge publish no events. Webhook deliveries already in flight when the purge commits complete normally, and previously enqueued delivery jobs no-op after the purge (their queued payloads are removed by the job queue's retention pruning rather than by this endpoint).

delete/v1/tenants/{tenant_id}/data

Path parameters

tenant_idstring required
Example:org-123

Tenant ID whose Hub-owned data should be deleted. Empty strings and NULL bytes are not allowed.

Response

Tenant data deleted

tenant_idstring required

Tenant ID whose data was deleted

deleted_feedback_recordsinteger required

Number of feedback records deleted

deleted_embeddingsinteger required

Number of embedding rows deleted

deleted_webhooksinteger required

Number of webhooks deleted

deleted_taxonomy_runsinteger required

Number of taxonomy runs deleted

deleted_taxonomy_clustersinteger required

Number of taxonomy clusters deleted

deleted_taxonomy_cluster_membershipsinteger required

Number of taxonomy cluster memberships deleted

deleted_taxonomy_nodesinteger required

Number of taxonomy nodes deleted

deleted_taxonomy_active_runsinteger required

Number of taxonomy active-run rows deleted

deleted_taxonomy_node_eventsinteger required

Number of taxonomy node events deleted

messagestring required

Human-readable status message

Example response

{
  "tenant_id": "org-123"
}