Skip to main content
DELETE
Revoke a share link

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

Body

application/json
dry_run
boolean
default:false

Validate and describe the change without performing it. Defaults to false over HTTP; the MCP write tools default it to true.

Response

The result of the revoke. applied: false with no audit entry means the link was already revoked. Revoke is not undoable.

dry_run
boolean
required
applied
boolean
required

False on a dry run and on every error.

diff
object
required

The change, in full. A dry run returns the change it WOULD make; an applied write returns the change it DID make, in the same shape, so the two can be compared directly.

audit_id
string<uuid>

Present on an applied write. The handle POST /audit/{auditId}/undo takes.

data
object