DELETE/api/organizations/{organization_id}Authenticated

Delete an organization

Deletes an organization together with its memberships and invitations. Only owners of the organization or platform administrators may delete it; system (hardcoded) organizations cannot be deleted.

operationId delete_api_organizations_organization_idOrganizations

Authentication & permissionsAuthenticated

Any authenticated user

Accepted credentials: Auth server session (refresh token cookie)cookie "refresh_token_<auth_server_app_id>"
Access token (cookie)cookie "access_token_<auth_server_app_id>"
Access token (Bearer)Authorization: Bearer <JWT>
Who may call: Any authenticated user
Notes: Only organization owners or platform administrators may delete an organization.

Path parameters

Name	Type	Description
organization_id*	string	Organization id (URL-safe slug)

Responses

application/json

SuccessMessageResponse

Property	Type	Description
success*	true
message*	string

JSONExample

"success"true

"message""string"

Example request

bashcurl

curl -X DELETE 'https://auth.schemavaults.com/api/organizations/<organization_id>' \
  -b 'refresh_token_<auth_server_app_id>=<value>'

Authentication & permissionsAuthenticated

Path parameters

Responses

200The organization was deleted

400The request failed validation (issues lists the offending fields) or was refused by the handler

401No valid session cookie, access token cookie or bearer access token was presented, or the token was revoked

403The account is disabled, or the credential is valid but not allowed to perform this operation

404No such organization

500Failed to delete the organization

Example request