SUsuprsend

Delete Tenant

Changed on

Delete a tenant by passing it's ID. Deletion does not affect in-flight notifications, which complete with the settings that were in effect at trigger time. When the tenant has sub-tenants, use children_action in the request body to control what happens to them.

delete/v1/tenant/{tenant_id}/

Request

Path parameters

tenant_idstring required

unique identifier of the tenant to delete

Request body

children_action'orphan' | 'reassign' | 'delete'

Only applies when the tenant has sub-tenants. orphan (default) promotes sub-tenants to root tenants. reassign moves sub-tenants under reassign_to tenant. delete deletes every sub-tenant in the subtree. Ignored for tenants with no sub-tenants.

reassign_tostring

Target parent when children_action = reassign. Must reference an existing tenant that is not the deleted tenant or one of its descendants. If omitted, sub-tenants are promoted to root tenants (same as orphan). See sub-tenants.

Example request

{
  "children_action": "reassign",
  "reassign_to": "acme-corp"
}

Response

204 - No Content

Changes