---
title: "Revoke Widget Embed Credential"
method: POST
path: "/v1/widgets/embed-credentials/{id}/revoke"
tags: ["Widgets"]
---

# Revoke Widget Embed Credential

`POST /v1/widgets/embed-credentials/{id}/revoke`

## Request

- Base URL: `https://api.sandbox.usenash.com`
- URL: `https://api.sandbox.usenash.com/v1/widgets/embed-credentials/{id}/revoke`
- Auth: none declared

Retire a credential immediately. Revocation is one-way — there is no un-revoke.

## Path parameters

- `id` string, required: The Nash widget embed credential id (``wec_…``).

## Response `200`

OK

- WidgetEmbedCredentialRead
  - `id` string, required
  - `organization_id` string, required
  - `name` string, required
  - `last_four` string, required
  - `expires_at` string, date-time, nullable
  - `revoked_at` string, date-time, nullable
  - `last_used_at` string, date-time, nullable
  - `created_by_user_id` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, nullable
  - `status` 'active' | 'expired' | 'revoked', required

## Other responses

- `422`: Unprocessable Content

---

[API](https://skmtc.dev/nash/apis/nash-api.md) - [All operations](https://skmtc.dev/nash/apis/nash-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nash/apis/nash-api/revisions/e3713837c5c9?raw)