Skip to main content
DELETE https://api.craftkit.dev/v1/renders/:id/shares/:shareId
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.

Authorization

Authorization
string
required
Bearer ck_live_…

Path parameters

id
string
required
The render id.
shareId
string
required
The share id to revoke.

Response

200:
id
string
The revoked share id.
revokedAt
string
ISO 8601 revocation timestamp.

Errors

StatuscodeMeaning
401unauthorizedMissing/invalid/revoked key.
404not_foundRender not found, or share not found / already revoked.
cURL
curl -X DELETE https://api.craftkit.dev/v1/renders/$RENDER_ID/shares/$SHARE_ID \
  -H "Authorization: Bearer $CRAFTKIT_API_KEY"
200
{
  "id": "…",
  "revokedAt": "2026-06-06T09:00:00.000Z"
}