link

Stop a link for good

Use this when the person wants a link to stop working, such as "stop the link I sent to Bo". It can't be undone: readers see that the company removed access, and sharing again takes a new link. Revoking a revoked link changes nothing.

post/links/{link_id}/revoke

Request

  • Base URL: https://localhost:4410/api/v1
  • URL: https://localhost:4410/api/v1/links/{link_id}/revoke
  • Auth: HTTP bearer

Path parameters

link_idstring required

The link to stop: link_create's id, or document_list's links_found.

Request body

object required

Response

The result.

idstring required
document_idstring nullable required
document_titlestring required
urlstring required
access'named' | 'email' | 'verified' | 'public' required
labelstring nullable required
recipient_emailstring nullable required
allowstring[] required
downloadsboolean required
detailed_analyticsboolean required
passcodeboolean required
noticestring nullable required
protection'open' | 'protected' | 'locked' required
mark_style'band' | 'tiled' required
round_idstring nullable required
public_blockedstring nullable required
expires_atstring date-time nullable required
state'active' | 'paused' | 'expired' | 'revoked' required
paused_reasonstring nullable required
viewsinteger required
last_viewed_atstring date-time nullable required
created_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.