> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blobhub.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Credential

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](/general/service-accounts)'s own key gets `403`
here for every target, even one it otherwise administers with `admin`. Use an
[acting token](/rest-api/auth/impersonate) when automation has to do this on a human's behalf.

<Note>
  Retiring a service account deletes the credentials stored on the account itself, without any call to this
  endpoint — see [Delete User](/rest-api/users/delete-user).
</Note>

### Example

<CodeGroup>
  ```bash Request theme={null}
  curl -X DELETE https://api.blobhub.io/v1/credentials/cred_001 \
    -H "X-API-Key: $ORG_API_KEY"
  ```

  ```json Response theme={null}
  {
    "status": "success"
  }
  ```
</CodeGroup>