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

# Revoke a share

> DELETE /v1/renders/:id/shares/:shareId — soft-delete a share so its public link stops resolving.

<Info>**DELETE** `https://api.craftkit.dev/v1/renders/:id/shares/:shareId`</Info>

Soft-deletes a share by stamping `revokedAt` (reason `revoked_by_partner`). The public
`/share/:token` URL stops resolving immediately. A share can only be revoked once — an
already-revoked or unknown share returns `404`. See [Sharing](/guides/sharing).

## Authorization

<ParamField header="Authorization" type="string" required>`Bearer ck_live_…`</ParamField>

## Path parameters

<ParamField path="id" type="string" required>The render id.</ParamField>
<ParamField path="shareId" type="string" required>The share id to revoke.</ParamField>

## Response

`200`:

<ResponseField name="id" type="string">The revoked share id.</ResponseField>
<ResponseField name="revokedAt" type="string">ISO 8601 revocation timestamp.</ResponseField>

## Errors

| Status | code           | Meaning                                                 |
| ------ | -------------- | ------------------------------------------------------- |
| 401    | `unauthorized` | Missing/invalid/revoked key.                            |
| 404    | `not_found`    | Render not found, or share not found / already revoked. |

```bash cURL theme={null}
curl -X DELETE https://api.craftkit.dev/v1/renders/$RENDER_ID/shares/$SHARE_ID \
  -H "Authorization: Bearer $CRAFTKIT_API_KEY"
```

```json 200 theme={null}
{
  "id": "…",
  "revokedAt": "2026-06-06T09:00:00.000Z"
}
```