---
title: "Delete a credential"
method: DELETE
path: "/tenants/{tenantId}/credentials/{credentialId}"
tags: ["Credentials"]
---

# Delete a credential

`DELETE /tenants/{tenantId}/credentials/{credentialId}`

Permanently delete (revoke) a credential. The credential can no longer be
used to send emails.

**Warning:** This action is irreversible. If you want to temporarily disable
a credential, use the update endpoint to set `hold: true` instead.

## Path parameters

- `tenantId` string, required
- `credentialId` integer, required

## Response `200`

Credential deleted

- object
  - `success` true, required
  - `data` object, required
    - `deleted` true, required
  - `meta` ApiMeta, required
    - `requestId` string, required — Unique request identifier for debugging and support

## Other responses

- `400` — Invalid credential ID
- `401` — Invalid or missing API key
- `403` — Missing required scope
- `404` — Credential or tenant not found
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/arkhq-io/apis/ark-email-api.md) · [All operations](https://skmtc.net/arkhq-io/apis/ark-email-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arkhq-io/ark-email-api/revisions/98a90852ffca/schema)