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

# Trabajos asíncronos y sondeo

> Comprende las escrituras basadas en tareas, los estados terminales de las tareas y qué recursos mantienen estado duradero.

# Trabajos asíncronos y sondeo

La mayoría de las operaciones de escritura son asíncronas.

## Qué devuelve inmediatamente

Estos endpoints aceptan trabajo y devuelven IDs que puedes sondear:

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

## Qué sondear

* Sondea `GET /tasks/{taskId}` para conocer el estado de ejecución y la salida de la tarea con datos hidratados.
* Consulta `GET /projects/{projectId}` para el estado del proyecto de larga duración.
* Consulta `GET /exports/{exportId}` para obtener URLs de descarga de exportación recientes.

## Modelo práctico de sondeo

1. Inicia una mutación y guarda los IDs devueltos.
2. Sondea `GET /tasks/{taskId}` hasta que la tarea alcance un estado terminal.
3. Vuelve a leer el recurso duradero por ID en lugar de confiar en estado obsoleto en caché.
4. Para descargas, consulta `GET /exports/{exportId}` cuando estés listo para usar la URL.

## Por qué esto importa

* El estado de la tarea es la línea de tiempo de ejecución.
* El estado del proyecto es la fuente de verdad duradera.
* Las URLs de descarga de exportación deben tratarse como actualizables en lugar de permanentes.