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

# Create new stitched VTT job

Add the following: (i) Video or audio files arranged in the desired order of stitching; (ii) VTT files corresponding to the desired order of stitching of video/audio files; (iii) Title for the stitched job -- this will be reflected in the output file name.

# 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": {
    "/stitched-vtt-jobs/create": {
      "post": {
        "summary": "Create new stitched VTT job",
        "description": "Add the following: (i) Video or audio files arranged in the desired order of stitching; (ii) VTT files corresponding to the desired order of stitching of video/audio files; (iii) Title for the stitched job -- this will be reflected in the output file name.",
        "tags": [
          "Stitched VTT Job"
        ],
        "operationId": "createStitchedVTTJob",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStitchedVTTJobRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateStitchedVTTJobResponse"
                }
              }
            }
          },
          "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": {
      "CreateStitchedVTTJobRequest": {
        "required": [
          "title",
          "video_files",
          "vtt_files"
        ],
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "description": "Job title",
            "example": "GMT Video Recording"
          },
          "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"
                }
              }
            }
          },
          "vtt_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 VTT caption file(s) for this job. If the VTT captions for this job are 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.vtt"
                }
              }
            }
          }
        }
      },
      "CreateStitchedVTTJobResponse": {
        "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
    }
  }
}
```