Delete a service account

delete

https://api.doit.com/iam/v1/service-accounts/{id}

Permanently deletes a service account and all of its API tokens, which stop authenticating immediately. Deleting an ID that no longer exists returns 404. Requires the serviceAccountManager permission.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

length ≥ 1

Service account ID, as returned in the id field by the list and create operations.

Query Params

dryRun

boolean

Defaults to false

If true, validates the request and returns the would-be result without applying it. The response then carries the X-Dry-Run header.

Headers

If-Match

string

required

The ETag of the current version, from a get, create or update response. A stale value returns 412; re-read the resource and retry with the new ETag.

Idempotency-Key

string

required

length between 1 and 255

Client-generated key (UUID v4 or ULID recommended). Retrying with the same key and request returns the stored response instead of repeating the operation; the key is kept for 24 hours.

string

enum

Defaults to application/problem+json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

*/*

application/problem+json

application/json

204No Content - Service account deleted, or validated when dryRun=true.

400Syntactically malformed request, missing required parameter, or unsupported parameter value.

401Unauthorized - Invalid API key.

403Forbidden - The client is not authorized to perform the request.

404The requested resource does not exist.

412The If-Match value no longer matches the current version of the resource.

428The request is missing the required If-Match header.

500Unexpected server error.