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

# List Video Compose Tasks

> Returns a paginated list of recent video composition tasks for the current license.



## OpenAPI

````yaml GET /api/open/v1/video-compose/list
openapi: 3.1.0
info:
  title: NavTalk API
  description: NavTalk API for AI avatar management, file uploads, and video generation
  version: 1.0.0
servers:
  - url: https://api.navtalk.ai
    description: NavTalk Production Environment Server
  - url: https://qaapi.navtalk.ai
    description: NavTalk QA Environment Server
  - url: https://devapi.navtalk.ai
    description: NavTalk Development Environment Server
security:
  - navtalkLicenseAuth: []
paths:
  /api/open/v1/video-compose/list:
    get:
      tags:
        - Video Compose
      summary: List Video Compose Tasks
      description: >-
        Returns a paginated list of recent video composition tasks for the
        current license.
      operationId: listVideoComposeTasks
      parameters:
        - name: page
          in: query
          description: Page number, starting from 1.
          required: false
          schema:
            type: integer
            default: 1
            minimum: 1
            example: 1
        - name: size
          in: query
          description: Page size.
          required: false
          schema:
            type: integer
            default: 10
            minimum: 1
            example: 10
      responses:
        '200':
          description: Task list retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VideoComposeListResponse'
              example:
                code: 200
                message: SUCCESS
                data:
                  list:
                    - taskId: 6d7e24b7-412d-46ec-8d95-940099a3e979
                      status: Published
                      title: My first synthesis task
                      videoUrl: https://api.navtalk.ai/uploadFiles/navtalk.Brain.mp4
                      thumbnailUrl: https://api.navtalk.ai/uploadFiles/navtalk.Brain.png
                      audioUrl: https://api.navtalk.ai/uploadFiles/2026-05-18/voice.mp3
                      resultUrl: >-
                        https://api.navtalk.ai/uploadFiles/2026-05-18/final-result.mp4
                  page: 1
                  size: 10
                  total: 1
                  pages: 1
                  hasMore: false
        '400':
          description: License validation failed or query error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NavtalkErrorResponse'
              example:
                code: 400
                message: Invalid license key
      security:
        - navtalkLicenseAuth: []
components:
  schemas:
    VideoComposeListResponse:
      type: object
      properties:
        code:
          type: integer
          example: 200
        message:
          type: string
          example: SUCCESS
        data:
          $ref: '#/components/schemas/VideoComposeListData'
    NavtalkErrorResponse:
      type: object
      properties:
        code:
          type: integer
          example: 400
        message:
          type: string
          example: Invalid license key
    VideoComposeListData:
      type: object
      properties:
        list:
          type: array
          items:
            $ref: '#/components/schemas/VideoComposeTask'
          description: Tasks in the current page.
        page:
          type: integer
          description: Current page number.
          example: 1
        size:
          type: integer
          description: Page size.
          example: 10
        total:
          type: integer
          format: int64
          description: Total task count.
          example: 1
        pages:
          type: integer
          description: Total page count.
          example: 1
        hasMore:
          type: boolean
          description: Whether another page is available.
          example: false
    VideoComposeTask:
      type: object
      properties:
        taskId:
          type: string
          description: Task ID.
          example: 6d7e24b7-412d-46ec-8d95-940099a3e979
        status:
          type: string
          enum:
            - Draft
            - Processing
            - Published
            - Fail
          description: Current task status.
          example: Published
        title:
          type: string
          description: Task title.
          example: My first synthesis task
        videoUrl:
          type: string
          description: >-
            Full public URL for the source visual asset associated with the
            task.
          example: https://api.navtalk.ai/uploadFiles/navtalk.Brain.mp4
        thumbnailUrl:
          type: string
          description: Full public thumbnail URL when available.
          example: https://api.navtalk.ai/uploadFiles/navtalk.Brain.png
        audioUrl:
          type: string
          description: Full public URL for the source audio used in the task.
          example: https://api.navtalk.ai/uploadFiles/2026-05-18/voice.mp3
        resultUrl:
          type: string
          description: >-
            Full public URL for the final generated video. Present when
            generation succeeds.
          example: https://api.navtalk.ai/uploadFiles/2026-05-18/final-result.mp4
        failMessage:
          type: string
          description: Failure message when `status` is `Fail`.
          example: Failed to generate audio from text
        prompt:
          type: string
          description: The original `textContent` submitted for TTS tasks.
          example: Hello, welcome to NavTalk.
        voice:
          type: string
          description: Voice key bound to the avatar when TTS is used.
          example: cedar
        voiceName:
          type: string
          description: Voice display name currently returned by the service.
          example: cedar
        avatarId:
          type: string
          description: Avatar ID used for this task, if applicable.
          example: 4024d39983b4d4b488bba9377268fbac
  securitySchemes:
    navtalkLicenseAuth:
      type: apiKey
      in: header
      name: license
      description: NavTalk API license key (e.g. sk_navtalk_...)

````