Clerk API (unofficial showcase)
DELETE/organizations/{organization_id}/domains/{domain_id}

Remove a domain from an organization

Deletes a domain from an organization. Use the organization_id and domain_id path parameters to identify the organization and domain to remove. A successful response indicates that the domain was deleted.

2 parameters
organization_idstringrequired
The ID of the organization to which the domain belongs.
domain_idstringrequired
The ID of the domain to remove.

5 status codes
200Returns a deleted-object response with the deletion status and, when provided, the object's ID, slug, and external ID.
objectstringrequired
idstringoptional
slugstringoptional
deletedbooleanrequired
external_idstringoptional
400Returned when the request is not successful.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
401Returned when authentication is invalid.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
403Returned when the request is not successful.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
404Returned when the resource is not found.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional

Error handling

A 400 is returned when the request is unsuccessful. A 401 indicates invalid authentication, a 403 indicates an unsuccessful request, and a 404 indicates that the resource was not found. The organization_id path parameter must identify the organization that owns the domain, and domain_id must identify the domain to remove.