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

# List in-flight queue items

> Lean polling view of the workbench render queue. Returns active generations (status queued or processing) by default; pass an explicit `status=` filter to include terminal rows. For paginated history with cost aggregates, use `/api/ai/generations`.



## OpenAPI

````yaml https://hub.oxen.ai/api/_spec/oxen_hub_api.json get /api/ai/queue
openapi: 3.0.0
info:
  title: oxen
  version: 0.231.0
servers:
  - url: https://hub.oxen.ai
    variables: {}
security: []
tags: []
paths:
  /api/ai/queue:
    get:
      tags: []
      summary: List in-flight queue items
      description: >-
        Lean polling view of the workbench render queue. Returns active
        generations (status queued or processing) by default; pass an explicit
        `status=` filter to include terminal rows. For paginated history with
        cost aggregates, use `/api/ai/generations`.
      operationId: OxenApiWeb.Controllers.QueueController.index
      parameters:
        - description: ''
          in: query
          name: namespace
          required: false
          schema:
            type: string
        - description: ''
          in: query
          name: model
          required: false
          schema:
            type: string
        - description: ''
          in: query
          name: media_type
          required: false
          schema:
            enum:
              - image
              - video
            type: string
        - description: ''
          in: query
          name: status
          required: false
          schema:
            enum:
              - queued
              - processing
              - succeeded
              - failed
              - cancelled
            type: string
        - description: ''
          in: query
          name: repo
          required: false
          schema:
            type: string
        - description: ''
          in: query
          name: folder
          required: false
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueueListResponse'
          description: Generation list
      callbacks: {}
components:
  schemas:
    QueueListResponse:
      description: >-
        Lean polling view of the workbench render queue. Active
        (`queued`/`processing`) rows by default; pass an explicit `status=`
        filter to include terminal rows. For paginated browse with cost
        aggregates, see `/api/ai/generations`.
      properties:
        count:
          type: integer
        generations:
          items:
            properties:
              completed_at:
                description: Unix timestamp
                nullable: true
                type: integer
              enqueued_at:
                description: Unix timestamp
                type: integer
              error_message:
                nullable: true
                type: string
              generation_id:
                format: uuid
                type: string
              media_type:
                enum:
                  - image
                  - video
                type: string
              model_name:
                type: string
              result_url:
                nullable: true
                type: string
              started_at:
                description: Unix timestamp
                nullable: true
                type: integer
              status:
                enum:
                  - queued
                  - processing
                  - succeeded
                  - failed
                  - cancelled
                type: string
              target_directory:
                nullable: true
                type: string
              target_namespace:
                nullable: true
                type: string
              target_repo:
                nullable: true
                type: string
            required:
              - generation_id
              - model_name
              - media_type
              - status
              - enqueued_at
            type: object
          type: array
      required:
        - count
        - generations
      title: QueueListResponse
      type: object

````