---
title: "Get task status"
method: GET
path: "/tasks/{taskId}"
tags: ["Tasks"]
---

# Get task status

`GET /tasks/{taskId}`

## Path parameters

- `taskId` string, required

## Response `200`

Task status and hydrated output

- Task
  - `id` string, required
  - `type` 'create-karaoke' | 'sync-lyrics' | 'stem-separation' | 'generate-video' | 'generate-chords' | 'export-stem-audio' | 'export-project', required
  - `status` 'created' | 'queued' | 'in-progress' | 'completed' | 'failed' | 'cancelled' | 'timed-out' | 'finalized', required
  - `error` string, nullable
  - `output` union
    - object
      - `projectId` string, required
    - object
      - `stemIds` string[]
      - `stems` object[]
        - `id` string, required
        - `type` 'original' | 'vocals' | 'instrumental' | 'backing_vocals', required
        - `model` string, required
        - `url` string, uri, required
        - `duration` number, nullable
    - object
      - `alignmentId` string
      - `alignment` object
        - `id` string, required
        - `model` string, required
        - `alignment` unknown, required
        - `createdAt` string, required
    - object
      - `exportId` string, required
      - `fileId` string

---

[API](https://skmtc.net/youka/apis/youka-rest-api.md) · [All operations](https://skmtc.net/youka/apis/youka-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/youka/youka-rest-api/revisions/4695792173d5/schema)