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

# Delete a credential

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

## Request

- Base URL: `https://api.arkhq.io/v1`
- URL: `https://api.arkhq.io/v1/tenants/{tenantId}/credentials/{credentialId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/arkhq-io/apis/ark-email-api/docs/tenants/:tenantId/credentials/:credentialId/delete.ts> (a function with typed inputs; its response is checked against the schema)

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

## Changes

- **2026-02-08** `37bce0c9a4d7`: 6 warning, 6 info
  - added the new `infrastructure_error` enum value to the `error/code` response property for the response status `400`
  - added the new `infrastructure_error` enum value to the `error/code` response property for the response status `401`
  - added the new `infrastructure_error` enum value to the `error/code` response property for the response status `403`
  - added the new `infrastructure_error` enum value to the `error/code` response property for the response status `404`
  - …8 more
- **2026-02-08** `4f8eeb0b9933`: 276 warning
  - added the new `already_exists` enum value to the `error/code` response property for the response status `400`
  - added the new `already_exists` enum value to the `error/code` response property for the response status `401`
  - added the new `already_exists` enum value to the `error/code` response property for the response status `403`
  - added the new `already_exists` enum value to the `error/code` response property for the response status `404`
  - …272 more
- **2026-02-08** `3aa940f5978d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/arkhq-io/apis/ark-email-api/changes/tenants/:tenantId/credentials/:credentialId/delete.md)

---

[API](https://skmtc.dev/arkhq-io/apis/ark-email-api.md) - [All operations](https://skmtc.dev/arkhq-io/apis/ark-email-api/llms.txt) - [OpenAPI document](https://skmtc.dev/arkhq-io/apis/ark-email-api/revisions/98a90852ffca?raw)