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

> Comprendi le scritture basate su task, gli stati terminali dei task e quali risorse mantengono uno stato durevole.

# Job asincroni e polling

La maggior parte delle operazioni di scrittura è asincrona.

## Cosa viene restituito immediatamente

Questi endpoint accettano il lavoro e restituiscono ID che puoi interrogare tramite polling:

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

## Cosa interrogare

* Esegui il polling su `GET /tasks/{taskId}` per lo stato di esecuzione e l’output del task idratato.
* Leggi `GET /projects/{projectId}` per lo stato del progetto a lunga durata.
* Leggi `GET /exports/{exportId}` per URL di download dell’export aggiornati.

## Modello pratico di polling

1. Avvia una mutazione e salva gli ID restituiti.
2. Esegui il polling su `GET /tasks/{taskId}` finché il task non raggiunge uno stato terminale.
3. Rileggi la risorsa durevole tramite ID invece di fidarti di uno stato obsoleto in cache.
4. Per i download, recupera `GET /exports/{exportId}` quando sei pronto a usare l’URL.

## Perché è importante

* Lo stato del task è la timeline di esecuzione.
* Lo stato del progetto è la fonte di verità durevole.
* Gli URL di download dell’export dovrebbero essere considerati aggiornabili, non permanenti.