Delete tenant data

DELETE/v1/tenants/{tenant_id}/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).

Path ParametersExpand Collapse

tenant_id: string

minLength1

maxLength255

ReturnsExpand Collapse

deleted_embeddings: number

Number of embedding rows deleted

formatint64

deleted_feedback_records: number

Number of feedback records deleted

formatint64

deleted_webhooks: number

Number of webhooks deleted

formatint64

message: string

Human-readable status message

tenant_id: string

Tenant ID whose data was deleted

minLength1

maxLength255

Delete tenant data

curl http://localhost:8080/v1/tenants/$TENANT_ID/data \
    -X DELETE \
    -H "Authorization: Bearer $HUB_API_KEY"

{
  "tenant_id": "org-123",
  "deleted_feedback_records": 42,
  "deleted_embeddings": 17,
  "deleted_webhooks": 3,
  "message": "Successfully deleted tenant data for org-123"
}

Returns Examples

{
  "tenant_id": "org-123",
  "deleted_feedback_records": 42,
  "deleted_embeddings": 17,
  "deleted_webhooks": 3,
  "message": "Successfully deleted tenant data for org-123"
}