Skip to main content
DELETE
/
api
/
v1
/
organizations
/
{orgId}
Delete Organization
curl --request DELETE \
  --url https://api.bunship.com/api/v1/organizations/{orgId} \
  --header 'Authorization: Bearer <token>'
{
  "message": "Organization deleted successfully"
}

Documentation Index

Fetch the complete documentation index at: https://docs.bunship.com/llms.txt

Use this file to discover all available pages before exploring further.

Soft-deletes an organization. Only the organization owner can perform this action. The organization and its data are marked as deleted but retained for a grace period before permanent removal.

​
Auth

Requires a valid Bearer token. Only the organization owner can delete it.

​
Path Parameters

​
orgId
string
required
Organization identifier.

​
Response

​
message
string
Confirmation message.
{
  "message": "Organization deleted successfully"
}

​
Errors

StatusCodeDescription
400VALIDATION_ERROROrganization has active resources preventing deletion
401AUTHENTICATION_ERRORMissing or invalid Bearer token
403AUTHORIZATION_ERROROnly the owner can delete the organization
404NOT_FOUNDOrganization not found

​
Example

curl -X DELETE https://api.bunship.com/api/v1/organizations/org_cld2abc123def456 \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."