Delete Credential - BlobHub

Delete a specific credential.

DELETE `/credentials/:id`

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	The unique ID of the credential.

Response

Returns {"status": "success"} — no body beyond the status.

Errors

Status	Error	Cause
403	`forbidden`	Missing `admin` access to the credential’s target, or no human behind the request.

Deleting a credential is a human act: a service account’s own key gets 403 here for every target, even one it otherwise administers with admin. Use an acting token when automation has to do this on a human’s behalf.

Retiring a service account deletes the credentials stored on the account itself, without any call to this endpoint — see Delete User.

Example

curl -X DELETE https://api.blobhub.io/v1/credentials/cred_001 \
  -H "X-API-Key: $ORG_API_KEY"

{
  "status": "success"
}