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

# Tasks

> Inspect low-level task execution state

Tasks are the underlying execution units for async work such as project creation, lyric sync, stem separation, and export rendering. Most workflows should stay at the `project` and `export` level.

Use `task` only when you need the raw task record for debugging or low-level automation.

## `task`

Get the latest state of a task by ID.

```bash theme={null}
youka task <taskId> --json
```

<ParamField path="taskId" type="string" required>
  The task ID, for example from a project's `stemTaskId` or `lyricsSyncTaskId`
  field.
</ParamField>

### Example

```bash theme={null}
# Capture the task id returned by a mutation
TASK_ID=$(youka project sync $PROJECT_ID --mode transcribe --json | jq -r '.data.taskId')

# Inspect the raw task record
youka task $TASK_ID --json
```

### Hidden escape hatch

`task` is intentionally hidden from the top-level `youka --help` output. It exists for debugging and agent workflows, not for the main happy path.

<Tip>
  Prefer `project wait`, `project show`, `export wait`, and `export show` unless
  you explicitly need low-level task fields.
</Tip>

## What's next

* [Projects](/en/cli/projects) - use `project wait` and `project show` for the common flow
* [Exports](/en/cli/exports) - use `export wait` and `export download` for rendered artifacts
* [AI agents](/en/agents) - polling and idempotency guidance