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

# List video generation tasks

> List video tasks persisted in the current GENGEN workspace. This endpoint
does not refresh task status from the upstream provider.




## OpenAPI

````yaml /openapi/gengen-v1.yaml get /contents/generations/tasks
openapi: 3.1.0
info:
  title: GENGEN API
  version: 1.0.0
  description: |
    The public GENGEN v1 API. New integrations should use normalized camelCase
    request fields and read generated media from the standard `outputs` object.
servers:
  - url: https://gengen.farm/api/gengen/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Video generation tasks
    description: Create, inspect, list, and cancel asynchronous video generation tasks.
  - name: Text generation
    description: Create OpenAI-compatible chat completions, including streamed responses.
  - name: Image generation
    description: Generate images synchronously with normalized GENGEN request fields.
  - name: Video understanding
    description: Analyze video content through the BytePlus Responses API surface.
  - name: Files
    description: Authorize direct uploads for image, video, and audio inputs.
paths:
  /contents/generations/tasks:
    get:
      tags:
        - Video generation tasks
      summary: List video generation tasks
      description: >
        List video tasks persisted in the current GENGEN workspace. This
        endpoint

        does not refresh task status from the upstream provider.
      operationId: listVideoGenerationTasks
      parameters:
        - name: page_num
          in: query
          description: Page number to return.
          schema:
            type: integer
            minimum: 1
            maximum: 500
            default: 1
        - name: page_size
          in: query
          description: Number of tasks per page.
          schema:
            type: integer
            minimum: 1
            maximum: 500
            default: 20
        - name: filter.status
          in: query
          description: |
            Filter by normalized task status.

            Supported values:

            - `queued` — waiting to start
            - `running` — currently processing
            - `cancelled` — cancelled before completion
            - `succeeded` — completed successfully
            - `failed` — stopped with an error
          schema:
            type: string
            enum:
              - queued
              - running
              - cancelled
              - succeeded
              - failed
        - name: filter.task_ids
          in: query
          description: |
            Public task IDs to include. Repeat this query parameter to provide
            multiple IDs.
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
        - name: filter.model
          in: query
          description: Exact public model ID.
          schema:
            type: string
        - name: filter.service_tier
          in: query
          description: |
            Filter by the saved service tier.

            Supported values:

            - `default` — standard online processing
            - `flex` — flexible offline processing when supported
          schema:
            type: string
            enum:
              - default
              - flex
      responses:
        '200':
          description: A paginated list of persisted video tasks.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VideoTaskList'
              example:
                items:
                  - id: seedance20:cgt-20260419-abcdef1234567890
                    model: dreamina-seedance-2-0-260128
                    status: succeeded
                    error: null
                    created_at: 1745380000
                    updated_at: 1745380132
                    content:
                      video_url: https://example.com/generated-video.mp4
                    usage:
                      completion_tokens: 23040
                      total_tokens: 23040
                page_num: 1
                page_size: 20
                total: 1
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        default:
          $ref: '#/components/responses/UnexpectedError'
components:
  schemas:
    VideoTaskList:
      type: object
      required:
        - items
        - page_num
        - page_size
        - total
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/VideoTaskListItem'
        page_num:
          type: integer
          minimum: 1
        page_size:
          type: integer
          minimum: 1
          maximum: 500
        total:
          type: integer
          minimum: 0
    VideoTaskListItem:
      type: object
      required:
        - id
        - model
        - status
        - created_at
        - updated_at
        - content
        - usage
      properties:
        id:
          type: string
        model:
          type: string
        status:
          type: string
        error:
          oneOf:
            - type: object
              additionalProperties: true
            - type: string
            - type: 'null'
        created_at:
          type: integer
          format: int64
          description: Unix timestamp in seconds.
        updated_at:
          type: integer
          format: int64
          description: Unix timestamp in seconds.
        content:
          type: object
          additionalProperties: true
        usage:
          type: object
          additionalProperties: true
      additionalProperties: true
    Error:
      type: object
      required:
        - error_code
      properties:
        error_code:
          type: string
          description: Stable machine-readable error code.
        error_params:
          type: object
          description: Optional structured error context.
          additionalProperties: true
        error:
          type: string
          description: Optional human-readable message.
      additionalProperties: true
  responses:
    BadRequest:
      description: The request body, path, or query parameters are invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error_code: gengen.model_required
            error_params:
              field: model
            error: A model is required
    Unauthorized:
      description: The bearer token is missing or invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error_code: gengen.auth_required
            error: Missing Authorization bearer token
    Forbidden:
      description: The API key is revoked, expired, or not authorized for the operation.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error_code: gengen.api_key_revoked
            error: GENGEN API key has been revoked
    UnexpectedError:
      description: GENGEN or an upstream provider could not complete the request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: GENGEN API key
      description: A workspace API key beginning with `gengen_live_`.

````