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

> Verstehen Sie aufgabenbasierte Schreibvorgänge, terminale Aufgabenstatus und welche Ressourcen dauerhaften Zustand enthalten.

# Asynchrone Jobs und Polling

Die meisten Schreibvorgänge sind asynchron.

## Was sofort zurückgegeben wird

Diese Endpunkte nehmen Arbeit entgegen und geben IDs zurück, die Sie abfragen können:

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

## Was abgefragt werden sollte

* Fragen Sie `GET /tasks/{taskId}` nach dem Ausführungsstatus und der hydratisierten Task-Ausgabe ab.
* Lesen Sie `GET /projects/{projectId}` für langlebigen Projektzustand.
* Lesen Sie `GET /exports/{exportId}` für aktuelle Export-Download-URLs.

## Praktisches Polling-Modell

1. Starten Sie eine Mutation und speichern Sie die zurückgegebenen IDs.
2. Fragen Sie `GET /tasks/{taskId}` ab, bis die Aufgabe einen terminalen Status erreicht.
3. Lesen Sie die dauerhafte Ressource per ID erneut, statt veraltetem, gecachtem Zustand zu vertrauen.
4. Für Downloads rufen Sie `GET /exports/{exportId}` ab, wenn Sie bereit sind, die URL zu verwenden.

## Warum das wichtig ist

* Der Task-Status ist der Ausführungszeitverlauf.
* Der Projektzustand ist die dauerhafte „Source of Truth“.
* Export-Download-URLs sollten als aktualisierbar statt als dauerhaft behandelt werden.