Tenants - Delete

Users with write privileges to a Tenant may delete the Tenant. If the Tenant to be deleted is the only Tenant the User is a member of, the User will be deleted from the system as well.

Delete Tenant

Endpoint

DELETE /1/tenants/{tenant_id}
Host: https://api.cogniac.io

Example: Delete a Tenant

cURL

curl - X DELETE https://api.cogniac.io/1/tenants/63QhzFLc9tg4 \
-H "Authorization: Bearer abcdefg.hijklmnop.qrstuvwxyz"

Python

import requests

my_headers = {"Authorization": "Bearer abcdefg.hijklmnop.qrstuvwxyz"}

res = requests.delete("https://api.cogniac.io/1/tenants/63QhzFLc9tg4",
                      headers=my_headers)

Expected Response

HTTP 204 Code (with no body)

❗️

Tenant Deletion

To delete a tenant, all subjects and applications must be deleted from the tenant. If there is an attempt to delete an tenant that still contains applications or subjects, the delete request will fail with an error.