Update a file link
Moves the expiry or replaces the metadata. Set expires_at to the literal now to expire the link immediately - the way to revoke a URL that is already in someone’s hands.
Authorizations
Your API key, e.g. Authorization: Bearer clmt_test_. Live keys use the clmt_live_ prefix.
Path Parameters
The file link's id.
^link_[0-9A-Za-z]{22}$Body
Response
The link afterwards.
A file link shares one file's contents with someone who holds no API key: the url serves the bytes without authentication until the link expires. Create one to hand a deliverable to your client or a downstream system. Only shareable files can be linked - an identity document can never be turned into a URL.
Entity name.
file_link ^link_[0-9A-Za-z]{22}$"link_0346sFPEvSkJvY8vt14NNw"
The file this link serves.
^file_[0-9A-Za-z]{22}$The public contents URL. The URL is the credential - anyone holding it can read the file until the link expires - so treat it like a secret.
Whether the link has expired. Expired links answer 404.
When the link stops serving. Absent means it never expires.
Your own key-value notes on the link, stored and returned verbatim.