> ## Documentation Index
> Fetch the complete documentation index at: https://docs.videnly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add video to queue

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

<Note type="warning">
  **Very Important:** This operation will use your account credits. Each video generated will reduce your credits. Most videos cost 1 credit, but not
  always, it depends on your chosen project settings, please proceed with caution.
</Note>

***


## OpenAPI

````yaml POST /v1/queue/add
openapi: 3.0.0
info:
  title: Videnly API
  version: 1.0.0
  description: API for managing video generation, queue, and user account details.
servers: []
security: []
paths:
  /v1/queue/add:
    post:
      tags:
        - Queue
      summary: Add video generation request to the queue
      description: Adds a video generation request to the queue for later processing.
      operationId: addQueue
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                projectId:
                  type: string
                overwriteSettings:
                  type: boolean
                customPrompt:
                  type: string
                  nullable: true
              required:
                - projectId
      responses:
        '200':
          description: Video generation request added successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                  message:
                    type: string
                  newQueueItem:
                    type: object
                    properties:
                      queueId:
                        type: string
                      projectId:
                        type: string
                      status:
                        type: string
                      generationProgress:
                        type: integer
                      renderProgress:
                        type: integer
                      videoUrl:
                        type: string
                        nullable: true
                      createdAt:
                        type: string
                        format: date-time
        '400':
          description: Invalid input or missing required fields
        '500':
          description: Server error
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Use format `Bearer YOUR_API_KEY`.

````