Skip to navigation
Paperwork APITools

Join files into one

View as Markdown

Joins 2 to 20 files, in the order you list them, into a single new file.

{ "files": ["call-part1.mp3", "call-part2.mp3"] }

Each entry is a file id or a file name. Every file must be the same kind:

  • Audio — the recordings are concatenated. format (mp3, m4a or wav) forces the output container; without it the inputs’ own container is kept. The result is named <first>.joined.<ext>.
  • PDF — the documents are merged into one. The result is named <first>.merged.pdf.

Mixing audio with PDFs answers 400. The files must be under 40 MB in total, otherwise the call answers 413 too_large.

Learn more: Working with files

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
fileslist of stringsRequired
formatenumOptional
Allowed values:

Response

The joined file.
object"file"
idstring
namestring
mimeTypestring
statusenum
Allowed values:
createdAtstring
parentFileIdstringOptional
metadatamap from strings to stringsOptional
errorstringOptional
uploadUrlstringOptional
uploadExpiresAtstringOptional
urlsobjectOptional

Errors

400
Bad Request Error
404
Not Found Error
409
Conflict Error
413
Content Too Large Error
429
Too Many Requests Error