Tasks

Tasks are the execution records behind async work. Project creation, lyric sync, stem separation, and cloud exports all return task IDs.

Endpoints

Method	Path	Purpose
`GET`	`/tasks/{taskId}`	Fetch one task by ID.
`GET`	`/projects/{projectId}/tasks`	List task history for a project.

Full request and response schemas are in API reference.

Poll one task

curl https://api.youka.io/api/v1/tasks/tsk_abc123 \
  -H "Authorization: Bearer yk_..."

Poll until status is terminal:

Status	Meaning
`completed`	The task finished successfully.
`finalized`	The task finished and was finalized.
`failed`	The task failed.
`cancelled`	The task was cancelled.
`timed-out`	The task timed out.

For successful project creation, lyric sync, and stem separation tasks, re-fetch the project after the task reaches a terminal state. For successful export tasks, fetch the export to get the signed download URL.

List project tasks

curl https://api.youka.io/api/v1/projects/prj_abc123/tasks \
  -H "Authorization: Bearer yk_..."

Use the project task list for diagnostics, progress timelines, and low-level automation that needs to correlate task IDs with project actions.

What’s next

Async jobs - recommended polling pattern
Projects - project creation and task history
Exports - cloud export tasks
SDK tasks - task polling helpers in TypeScript

Guides

Resources

API Reference

Endpoints

Poll one task

List project tasks

What’s next

​Endpoints

​Poll one task

​List project tasks

​What’s next

Endpoints

Poll one task

List project tasks

What’s next