Skip to content

Delete a credential

DELETE
/v1/credentials/{id}
curl --request DELETE \
--url https://example.com/v1/credentials/example \
--header 'Authorization: Bearer <token>'
id
required
string

The cred_<uuidv7> credential ID.

Deleted.

Missing or invalid bearer token, or the token’s tenant/user claims are absent. No body.

No resource with this ID exists in the caller’s tenant.

Media typeapplication/json

The uniform error body for all 4xx responses that carry one.

object
error
required

A coarse, caller-safe message. Never contains internal state (invariant

string
Examplegenerated
{
"error": "example"
}

The credential is still referenced by one or more agents (credential_ref or facilitator_credential_ref).

Media typeapplication/json

The uniform error body for all 4xx responses that carry one.

object
error
required

A coarse, caller-safe message. Never contains internal state (invariant

string
Examplegenerated
{
"error": "example"
}

An unexpected server-side error. No body (internal detail is never returned to callers, invariant