---
agentTools:
  projectIndex: https://threadeo.readme.io/llms.txt
---

# Create new unified upload job

Add the following: (i) Video or audio files arranged in the desired order of stitching; (ii) Single certified transcript (ASCII/TXT format only) for this job; (iii) All exhibits associated with this job; (iv) Title for the stitched job -- this will be reflected in the output file name. The output can be only a sync, or optionally include an AI summary of the deposition transcript as well.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Threadeo API",
    "contact": {
      "email": "engineering@threadeo.com"
    },
    "version": "1.7.0"
  },
  "servers": [
    {
      "url": "https://api.threadeo.com/v1"
    }
  ],
  "paths": {
    "/unified-upload-jobs/create": {
      "post": {
        "summary": "Create new unified upload job",
        "description": "Add the following: (i) Video or audio files arranged in the desired order of stitching; (ii) Single certified transcript (ASCII/TXT format only) for this job; (iii) All exhibits associated with this job; (iv) Title for the stitched job -- this will be reflected in the output file name. The output can be only a sync, or optionally include an AI summary of the deposition transcript as well.",
        "tags": [
          "Unified Upload Job"
        ],
        "operationId": "createUnifiedUploadJob",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateUnifiedUploadJob"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateUnifiedUploadJobResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorJSONResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorJSONResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": []
          },
          {
            "BearerAuth": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "CreateUnifiedUploadJob": {
        "required": [
          "title",
          "video_files",
          "create_summary"
        ],
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "description": "Job title",
            "example": "Deposition of John Smith"
          },
          "video_files": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "description": "One or more public URL(s) from which Threadeo will fetch the video or audio file(s) for this job. If the video or audio for this job is spread across multiple files, add each file URL individually. Ensure that file URLs are added in the desired sequence of stitching.",
                  "example": "https://bucket.s3.us-east-1.amazonaws.com/video.part-1.mp4"
                }
              }
            }
          },
          "ascii_file": {
            "type": "string",
            "description": "A public URL from which Threadeo will fetch the certified transcript (in ASCII/TXT) format for this job.",
            "example": "https://bucket.s3.us-east-1.amazonaws.com/john-smith-certified-transcript.txt"
          },
          "exhibit_files": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "url",
                "file_name",
                "exhibit_title"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "description": "A public URL from which Threadeo will fetch an exhibit for this job.",
                  "example": "https://bucket.s3.us-east-1.amazonaws.com/exhibit-15.pdf"
                },
                "file_name": {
                  "type": "string",
                  "example": "Exhibit 15.pdf"
                },
                "exhibit_title": {
                  "type": "string",
                  "description": "Typically matches the exhibit file name to facilitate automated exhibit linking within the transcript text.",
                  "example": "Exhibit 15"
                },
                "aliases": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "description": "An alternative title for the exhibit, which deposition participants may use to refer to this exhibit, and which will be automatically linked to this exhibit in the transcript text.",
                    "example": "Smith Email"
                  }
                }
              }
            }
          },
          "create_summary": {
            "type": "boolean",
            "description": "Whether or not to generate a summary from the certified transcript after it is synchronized."
          }
        }
      },
      "CreateUnifiedUploadJobResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "example": 1
          }
        }
      },
      "ErrorJSONResponse": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "Error message",
            "example": "Error message"
          }
        }
      }
    },
    "securitySchemes": {
      "APIKey": {
        "type": "apiKey",
        "name": "x-api-key",
        "description": "The API key on your API Settings page (https://app.threadeo.com/profile/api-settings).",
        "in": "header"
      },
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "The secret token you generated on your API Settings page."
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "_id": {
    "buffer": {
      "0": 96,
      "1": 105,
      "2": 138,
      "3": 79,
      "4": 124,
      "5": 80,
      "6": 237,
      "7": 0,
      "8": 22,
      "9": 230,
      "10": 68,
      "11": 196
    }
  }
}
```