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

# Tâches asynchrones et interrogation

> Comprendre les écritures basées sur des tâches, les états terminaux des tâches et quelles ressources contiennent un état durable.

# Tâches asynchrones et interrogation

La plupart des opérations d’écriture sont asynchrones.

## Ce qui renvoie immédiatement

Ces endpoints acceptent du travail et renvoient des IDs que vous pouvez interroger :

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

## Ce qu’il faut interroger

* Interrogez `GET /tasks/{taskId}` pour l’état d’exécution et la sortie de la tâche hydratée.
* Consultez `GET /projects/{projectId}` pour l’état du projet à long terme.
* Consultez `GET /exports/{exportId}` pour des URL de téléchargement d’export à jour.

## Modèle d’interrogation pratique

1. Démarrez une mutation et stockez les IDs renvoyés.
2. Interrogez `GET /tasks/{taskId}` jusqu’à ce que la tâche atteigne un état terminal.
3. Relisez la ressource durable par ID au lieu de vous fier à un état en cache obsolète.
4. Pour les téléchargements, récupérez `GET /exports/{exportId}` lorsque vous êtes prêt à utiliser l’URL.

## Pourquoi c’est important

* Le statut de la tâche est la chronologie d’exécution.
* L’état du projet est la source de vérité durable.
* Les URL de téléchargement d’export doivent être considérées comme actualisables plutôt que permanentes.