Skip to main content

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 are the execution records behind async work. Project creation, lyric sync, stem separation, and cloud exports all return task IDs.

Endpoints

MethodPathPurpose
GET/tasks/{taskId}Fetch one task by ID.
GET/projects/{projectId}/tasksList 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:
StatusMeaning
completedThe task finished successfully.
finalizedThe task finished and was finalized.
failedThe task failed.
cancelledThe task was cancelled.
timed-outThe 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