---
title: "Add video generation request to the queue"
method: POST
path: "/v1/queue/add"
tags: ["Queue"]
---

# Add video generation request to the queue

`POST /v1/queue/add`

Adds a video generation request to the queue for later processing.

## Request body

- object
  - `projectId` string, required
  - `overwriteSettings` boolean
  - `customPrompt` string, nullable

## Response `200`

Video generation request added successfully

- object
  - `status` string
  - `message` string
  - `newQueueItem` object
    - `queueId` string
    - `projectId` string
    - `status` string
    - `generationProgress` integer
    - `renderProgress` integer
    - `videoUrl` string, nullable
    - `createdAt` string, date-time

## Other responses

- `400` — Invalid input or missing required fields
- `500` — Server error

---

[API](https://skmtc.dev/videnly/apis/videnly-api.md) · [All operations](https://skmtc.dev/videnly/apis/videnly-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/videnly/videnly-api/revisions/4a794bda6876/schema)