跳至主要内容

Delete an organization

DELETE 
/api/v1/orgs/{orgId}

Remove an organization by its ID. Requires confirmation of the organization name.

Usage DELETE /orgs/{orgId}?orgName={orgName}

Parameters

  • orgId (Guid, required): ID of the organization.
  • orgName (string, required): The name of the organization, used for confirmation.

Responses

  • 204 No Content: organization deleted successfully.
  • 400 Bad Request: orgName does not match the actual organization name.
  • 403 Forbidden: caller is not admin, target is root org, org has sub-organizations, devices, or other users.
  • 404 Not Found: organization not found.

Security

  • This API requires authentication.
  • Only an admin of the target org may delete it.
  • Root organizations cannot be deleted.
  • Organizations with sub-orgs, devices, or other users cannot be deleted.

Request​

Responses​

No Content