v1

latestOpenAPI 3.1.02026-08-066378446.6 KB

Document Operations

Create public link

<small>Requires an API token with the Document Manager role.</small>

Creates a public link for the document. Anyone who has the link URL can view the document with it, so treat the URL like a secret.

A document has at most one active public link at a time; if one already exists, a 409 response is returned. Delete the existing link first to create a new one with a fresh URL.

Note: Public links cannot be created while the document is in the draft or approved_draft stage. Attempting to do so will return a 409 response.

post/documents/{document}/public-link

Path parameters

documentstring required

The document UUID

Request body

expires_atstring date-time nullable

When the link stops working. Defaults to 3 months from now; pass null for a link that never expires

Example request

{
  "expires_at": "2026-10-19T12:00:00Z"
}

Response

ShareableLinkResource

Example response

{
  "data": {
    "uuid": "5cbe6ed1-49a9-40dc-a1c4-9e5a3c9a08f0",
    "url": "https:app.fynk.com/share/5cbe6ed1-49a9-40dc-a1c4-9e5a3c9a08f0?token=...",
    "expires_at": "2026-10-19T12:00:00Z",
    "message": "Hi Emily, please review the updated contract."
  }
}