Revoke a share link
Revoke a share link: the URL stops answering (a 404) immediately and the frozen copy is deleted; caches may hold served bytes for up to an hour. Returns {status: "unshared", share_id}. SCOPE: one public URL your org minted. The artifact itself is untouched - share_artifact mints a fresh URL (new secret) any time - so retracting a link that should no longer be public is the safe direction, and reversible. Works on any of your org's shares; list_shares shows what is live.
Request
- Base URL: https://autoresearch.sfcompute.com
- URL: https://autoresearch.sfcompute.com/preview/shares/{id}
- Auth: HTTP bearer
Path parameters
The shr-... id returned by share_artifact (or list_shares).
Query parameters
Act in this workspace (its slug). Omitted: the token's bound workspace, then the organization's default. Never ambient - there is no switch-workspace mutation on this door.
Response
The capability's JSON result.
Changes
No recorded changes to this operation across all 1 revision of this API.