Skip to main content
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