> ## 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.

# Async jobs and polling

> कार्य-आधारित writes, terminal task states, और किन resources में durable state होता है—इसे समझें।

# Async jobs and polling

अधिकांश write operations asynchronous होते हैं।

## What returns immediately

ये endpoints काम स्वीकार करते हैं और IDs लौटाते हैं जिन्हें आप poll कर सकते हैं:

* `POST /projects`
* `POST /projects/{projectId}/tasks/stem-separation`
* `POST /projects/{projectId}/tasks/lyrics-sync`
* `POST /projects/{projectId}/exports`

## What to poll

* execution status और hydrated task output के लिए `GET /tasks/{taskId}` poll करें।
* long-lived project state के लिए `GET /projects/{projectId}` पढ़ें।
* fresh export download URLs के लिए `GET /exports/{exportId}` पढ़ें।

## Practical polling model

1. एक mutation शुरू करें और लौटाए गए IDs स्टोर करें।
2. `GET /tasks/{taskId}` को तब तक poll करें जब तक task किसी terminal state तक न पहुँच जाए।
3. stale cached state पर भरोसा करने के बजाय ID से durable resource को दोबारा पढ़ें।
4. downloads के लिए, URL इस्तेमाल करने के लिए तैयार होने पर `GET /exports/{exportId}` fetch करें।

## Why this matters

* Task status execution timeline है।
* Project state durable source of truth है।
* Export download URLs को permanent की बजाय refreshable मानकर चलना चाहिए।