FIfirma
Templates

Remove a document from a template

Changed on

Removes a document from the template. The last remaining document cannot be removed (400 MIN_DOCUMENTS_REQUIRED).

Available to every company. This operation is part of the multi-document contract (API 01.39.00). For a signing request or template the API key cannot see, it answers 404 with code NOT_FOUND ("Endpoint not found"), exactly as an unknown endpoint does. While multi-document editing is suspended, this operation returns 409 MULTI_DOCUMENT_READ_ONLY for parents on the multi-document read-only path and 404 NOT_FOUND for parents on the single-document path.

delete/templates/{id}/documents/{document_id}

Request

Path parameters

idstring uuid required

Template ID

document_idstring uuid required

The document id (documents[].document_id)

Response

Document removed; the full document set after the change

documents_versioninteger required
documents_layout_versioninteger required

Example response

{
  "documents": [
    {
      "document_id": null,
      "position": 1,
      "label": null,
      "original_filename": null,
      "page_count": 3,
      "document_url": "https://api.firma.dev/storage/v1/object/sign/signing-request-documents/example.pdf?token=example",
      "document_url_kind": "stored",
      "document_only_hash": null
    }
  ]
}

Changes