Sign in

v4

latestOpenAPI 3.1.02026-08-0143190206.8 KB
v1

Revoke the active public URL for a file. The underlying file remains available through the authenticated content endpoint. Revoke is idempotent — calling it on a file without an active public URL returns `revoked: false` without an error.

post/v1/files/{file_id}/public-url/revoke

Path parameters

file_idstring required

The file's id.

Response

Success

idstring required

The file ID whose public URL was revoked.

public_urlstring nullable

The full public URL that was revoked. Only present when revoked is true.

revokedboolean required

Whether a public URL was actually revoked. false if the file had no active public URL (no-op).