Create a file mission

post https://api.dottedsign.com/v1/file_missions

Create a file mission.

For this action, you can create a file mission to merge multiple PDF files into one PDF file.

When uploading via the upload_link in the response, please upload the file in its original format. For example, if using curl, use --data-binary 'path/to/your/file', or in Postman, select Body > Binary.
After the action, you can use the returned file_mission_id to Create a task with the merged PDF file.

📑
Uploading Multiple Files
When uploading multiple files, please note the following points:

See Sign a Task and Upload Attachments for more details on how to upload files.

Each file should not exceed 10MB.

You can upload up to 10 files.

Only PDF format is accepted.

Encrypted PDF files are not accepted.

PDF files will be merged asynchronously.

If you want to check the upload status, you can use the Get a file mission action.

scope: files.general.write
available user plans: all

Responses

Language


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api.dottedsign.com/v1/file_missions \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'


xxxxxxxxxx
62
}
1
{
2
  "data": {
3
    "file_mission_id": 1,
4
    "status": "file_uploading",
5
    "files": [
6
      {
7
        "file_object_id": "DottedSignAPI_File_4b73507d-30c7-4a85-9b45-00ce7406299f",
8
        "file_name": "file1",
9
        "upload_link": "https://bucket.s3.us-stubbed-1.amazonaws.com/file?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20250317%2Fus-stubbed-1%2Fs3%2Faws4_request&X-Amz-Date=20250317T041743Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=bf1532d8b8f87176e6d7d7e0eba3c72dbf3c918a3028b8fba6ba350772ac3cde"
10
      },
11
      {
12
        "file_object_id": "DottedSignAPI_File_20e83550-5aee-424e-99cc-5ff8b16b3bbf",
13
        "file_name": "file2",
14
        "upload_link": "https://bucket.s3.us-stubbed-1.amazonaws.com/file?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20250317%2Fus-stubbed-1%2Fs3%2Faws4_request&X-Amz-Date=20250317T041743Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=bf1532d8b8f87176e6d7d7e0eba3c72dbf3c918a3028b8fba6ba350772ac3cde"
15
      },
16
      {
17
        "file_object_id": "DottedSignAPI_File_fd07d475-8375-41c4-b084-b0abc3123d3a",
18
        "file_name": "duplicate_file_name",
19
        "upload_link": "https://bucket.s3.us-stubbed-1.amazonaws.com/file?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20250317%2Fus-stubbed-1%2Fs3%2Faws4_request&X-Amz-Date=20250317T041743Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=bf1532d8b8f87176e6d7d7e0eba3c72dbf3c918a3028b8fba6ba350772ac3cde"
20
      },
21
      {
22
        "file_object_id": "DottedSignAPI_File_5201f7f0-0550-4a3f-877e-e2ea1f4532ea",
23
        "file_name": "duplicate_file_name",
24
        "upload_link": "https://bucket.s3.us-stubbed-1.amazonaws.com/file?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=stubbed-akid%2F20250317%2Fus-stubbed-1%2Fs3%2Faws4_request&X-Amz-Date=20250317T041743Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=bf1532d8b8f87176e6d7d7e0eba3c72dbf3c918a3028b8fba6ba350772ac3cde"
25
      },

Content-Type
Content-Length

200200

400400