---
title: "Revoke an owned credential without deleting its history"
method: DELETE
path: "/account-credentials/{credentialId}"
tags: ["Account credentials"]
---

# Revoke an owned credential without deleting its history

`DELETE /account-credentials/{credentialId}`

## Request

- Base URL: `https://app.communicate.so/api/v1`
- URL: `https://app.communicate.so/api/v1/account-credentials/{credentialId}`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `__Secure-better-auth.session_token`
  - API key in cookie `better-auth.session_token`

Use an explicit credentials:write account bearer grant or a live email-verified application session, plus the current account password as fresh identity proof. Cookie writes require a trusted Origin. Machine callers cannot issue scopes beyond their own grant or outlive it. Creation and rotation return the secret once; metadata never includes it. Scope and expiry can only be narrowed. Issued credentials expire within 24 hours and no later than their issuer session; session revocation invalidates them.

## Path parameters

- `credentialId` string, uuid, required

## Headers

- `Origin` string, uri

## Request body

- AccountCredentialProof
  - `password` string, password, required

## Response `200`

Revoke an owned credential without deleting its history

- AccountCredentialRevocation
  - `id` string, uuid, required
  - `revokedAt` string, date-time, required

## Other responses

- `400`: Invalid request body or pagination.
- `401`: Session or credential missing, invalid, expired or revoked; fresh password proof failed when required.
- `403`: Email verification, trusted origin or required account scope is missing.
- `404`: Credential not found in the authenticated user account.
- `429`: Per-user list or password proof rate limit exceeded.
- `500`: Unexpected server failure.
- `503`: Identity service or freshly issued session unavailable.

---

[API](https://skmtc.dev/communicate/apis/communicate-public-rest-api-2.md) · [All operations](https://skmtc.dev/communicate/apis/communicate-public-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/communicate/apis/communicate-public-rest-api-2/revisions/db6be3d36733?raw)