Delete a service account

DELETE

/v1/orgs/{org}/service-accounts/{account}

Ends the service account at once:

Its membership is revoked, so its Box grants stop working.
Every API key it holds is revoked; requests with them fail with 401 unauthenticated.
Its name is freed for a new service account. The old account stays on record under a changed identity, as List members shows.

Boxes it created stay in the organization. Remove a member with the service account's ID does the same as this route.

Only the organization's owners and admins may call this route, with a sign-in session; API keys are refused.

Authorization

session

headerAuthorizationBearer <token>

A sign-in session token (jvs_…) from the Dashboard, cubicle login or the device authorization flow.

org*string

The organization's ID or name. An organization where the caller is not an active member returns 404.

account*string

The service account's ID, or its NAME without the organization (ci for acme/ci). A UUID is always read as an ID.

The service account is deleted.

Example Request

curl -X DELETE 'https://api.cubicle.sh/v1/orgs/acme/service-accounts/ci'

Example Request

curl -X DELETE 'https://api.cubicle.sh/v1/orgs/acme/service-accounts/ci'

Example Response

Empty