links

Duplicate a public link

Creates a new public link with the same document, signature slots, language, print setting and AI assistant configuration as the source. The copy gets its own URL — the source link is untouched and keeps working.

The copy is independent: it gets its own copy of the document rather than sharing the source's, so deleting the link you copied from never affects it, and a link duplicated from a colleague's shared one belongs entirely to you.

Billing

A duplicate is a new link, and is billed exactly like POST /links: it allocates its own instance and is charged pro rata for the rest of the current period. 402 if the wallet cannot cover it, 403 if the subscription is suspended.

Notes

  • Reading the source only requires access to it, so a link shared with the account can be duplicated by any member. The copy belongs to whoever duplicated it.
  • If the source stores pre-filled names on its slots and it belongs to a colleague, those names are not carried over — they are stored per user.
post/links/{linkId}/duplicate

Request

  • Base URL: https://docs-api.formify.eu/v1
  • URL: https://docs-api.formify.eu/v1/links/{linkId}/duplicate
  • Auth: OAuth 2 (authorization code, authorization URL https://docs-api.formify.eu/v1/oauth/authorize, token URL https://docs-api.formify.eu/v1/oauth/token, scopes: write)

Path parameters

linkIdstring uuid required

The unique identifier of the public link to copy.

Request body

namestring

Name for the copy. Defaults to the source's name when omitted, which leaves you with two items of the same name.

errorLanguage'en' | 'sv' | 'es'

Language for error messages

Response

Public link duplicated successfully

linkIdstring uuid

Unique identifier of the public link

namestring

Name of the link

createdAtstring date-time

When the link was created

updatedAtstring date-time nullable

When the link was last edited

userIdstring uuid

User ID of the link owner

sharingSetting'shared' | 'private'

Who on the account may administer the link

status'active' | 'disabled' | 'processing'
  • active: the link is live and can be opened and signed.
  • disabled: the link has been switched off and no longer accepts new signers. Documents already produced by it are unaffected. There is no way to switch it back on.
  • processing: the AI assistant is still reading the document. linkUrl is null and the link cannot be edited until this finishes.

Note this is a different set of values from a document's status — a link is a source of documents rather than a signature request, so it has no signing progress of its own.

linkUrlstring nullable

The link to share. null while status is processing, because the document is not servable yet.

Uses the account's custom domain when one is configured. Formify never sends this to anyone — distributing it is up to you.

Changes

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