> ## 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.

# Clear Queue Item

> Endpoint to clear a specific video generation request from the queue for the authenticated user.

<Note type="warning">**Note:** Clearing a queue item is irreversible.</Note>

## Clear Queue Item

This endpoint clears a specific video generation request from the queue for the authenticated user.

### Request

* **Endpoint**: `POST /v1/queue/clear`
* **Authorization**: Bearer token required

#### Request Body

| Parameter | Type     | Required | Description                        |
| --------- | -------- | -------- | ---------------------------------- |
| `queueId` | `string` | Yes      | The ID of the queue item to clear. |

#### Example Request

```bash theme={null}
curl -X POST https://api.videnly.com/v1/queue/clear \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "queueId": "xxxxxxxxxxxxxxxxxxxxxxxx"
}'
```


## OpenAPI

````yaml POST /v1/queue/clear
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/clear:
    post:
      tags:
        - Queue
      summary: Clear a specific queue item
      description: Deletes a specific queue item belonging to the authenticated user.
      operationId: clearQueueItem
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                queueId:
                  type: string
              required:
                - queueId
      responses:
        '200':
          description: Queue item cleared successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                  message:
                    type: string
                  queueId:
                    type: string
        '400':
          description: Invalid queue ID format
        '404':
          description: Queue item not found or not owned by the user
        '500':
          description: Server error
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Use format `Bearer YOUR_API_KEY`.

````