Revoke a share

DELETE/v1/shares/{id}

Revokes a share token; its link 404s immediately. Other shares of the deck are unaffected.

Requires an API key (bearer), scoped to the active org. Supports idempotency keys.

Path parameters

idstringrequired

Returns

200The revoked share.

Failures use the standard error envelope with a closed set of codes.

Terminal

renza shares revoke shr_7a2c…

DELETE /v1/shares/{id}

curl https://api.renza.io/v1/shares/shr_7a2c… \
  -H "Authorization: Bearer $RENZA_API_KEY" \
  -X DELETE

TypeScript

import { createRenzaClient } from "renza-sdk";

const renza = createRenzaClient({ apiKey: process.env.RENZA_API_KEY! });

const share = await renza.shares.revoke("shr_7a2c…");

Response 200

{
  "id": "shr_7a2c…",
  "object": "share",
  "token": "X3k9...x",
  "deck": "deck_2a9f8c1b",
  "mode": "link",
  "url": "https://renza.io/v/X3k9…x",
  "expires_at": null,
  "revoked_at": null,
  "created_at": "2026-06-19T10:30:00.000Z"
}