files

Merge multiple PDF files into a single document

Merges two or more uploaded PDF files into a single file. The resulting file will be assigned a new fileId.

Requirements

  • File Format: Only pre-uploaded PDF files are supported for merging.
  • Order of Merge: The files will be merged in the order of the provided fileIds.
  • File Name: A name for the resulting merged file must be provided.
  • Max File Size: Ensure the combined file size does not exceed system limits (50 MB).
  • 2-8 Files: A minimum of 2 files and a maximum of 8 fileIds are required (duplicate fileIds are not allowed.).

This endpoint is particularly useful for workflows where multiple PDF files need to be combined before sending them for signatures or further processing.

post/files/merge

Request

  • Base URL: https://docs-api.formify.eu/v1
  • URL: https://docs-api.formify.eu/v1/files/merge
  • 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)

Request body

fileIdsstring[]

List of File IDs to merge. Must contain between 2 and 8 unique File IDs.

namestring

Name for the resulting merged file.

Example request

{
  "fileIds": [
    "123e4567-e89b-12d3-a456-426614174000",
    "123e4567-e89b-12d3-a456-426614174001"
  ],
  "name": "Merged Document"
}

Response

Files merged successfully.

fileIdstring uuid

The unique identifier of the merged file.

Example response

{
  "fileId": "123e4567-e89b-12d3-a456-426614174002"
}

Changes

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