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

> Entenda gravações baseadas em tarefas, estados terminais de tarefas e quais recursos mantêm estado durável.

# Jobs assíncronos e polling

A maioria das operações de escrita é assíncrona.

## O que retorna imediatamente

Esses endpoints aceitam o trabalho e retornam IDs que você pode consultar por polling:

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

## O que consultar por polling

* Faça polling em `GET /tasks/{taskId}` para obter o status de execução e a saída da tarefa com dados completos.
* Leia `GET /projects/{projectId}` para obter o estado do projeto de longa duração.
* Leia `GET /exports/{exportId}` para obter URLs novas para download do export.

## Modelo prático de polling

1. Inicie uma mutação e armazene os IDs retornados.
2. Faça polling em `GET /tasks/{taskId}` até a tarefa atingir um estado terminal.
3. Releia o recurso durável pelo ID em vez de confiar em estado em cache desatualizado.
4. Para downloads, busque `GET /exports/{exportId}` quando você estiver pronto para usar a URL.

## Por que isso importa

* O status da tarefa é a linha do tempo da execução.
* O estado do projeto é a fonte de verdade durável.
* As URLs de download do export devem ser tratadas como atualizáveis, e não como permanentes.