Perguntas frequentes

Perdi o token. Dá para recuperar?

Não. O que fica gravado é o sha256 dele. Gere outro, e lembre que gerar revoga o anterior: se um script já usava o antigo, ele para de funcionar na hora.

Por que a criação pede `tenantId` toda vez?

Porque o espaço de trabalho é a fronteira de isolamento, e ele é imutável: escolhido na criação, ele nunca mais muda. A única criação que não pede é a do epic, que herda o espaço do projeto.

Mandei um `columnId` válido e recebi 422

A coluna provavelmente é de outro conjunto. Com columnScope: PROJECT, um card com projeto usa as colunas daquele projeto, e não as do espaço. Peça GET /api/columns?tenant=…&project=… para receber exatamente o conjunto em vigor.

O prazo aparece um dia antes/depois

Faltou dueAtZone. O instante sozinho não diz o dia: quem responde isso é o fuso em que a data foi declarada, e ele viaja junto no card.

O `favorite` volta diferente para cada pessoa

É o comportamento correto. O favorito é pessoal: a marca é uma linha entre a conta e o card, e o campo é a resposta para quem pediu.

Um lote falhou. Quantos cards mudaram?

Nenhum. Operação em lote recusa inteira: ou todos mudam, ou nenhum muda. Corrija o corpo e repita à vontade.

Como gravo uma entrada de histórico?

Não se grava. O histórico é escrito pelo servidor, na mesma transação que muda a coluna. Não existe rota de escrita: o histórico não pode ser editado.

Existe `GET /api/backup/export`?

Não. A exportação é um job: agenda-se com POST /api/backup/job, acompanha-se com o GET da mesma rota e baixa-se com GET /api/backup/file.

Como faço paginação?

Não há. As listagens devolvem o conjunto inteiro do filtro pedido, e o filtro que existe é o espaço de trabalho, aplicado no servidor.

Estou tomando 429 num script de carga

O limite padrão é 300 requisições por minuto por IP, configurável por NOTEBUGS_RATE_LIMIT. A resposta traz Retry-After em segundos: respeite-o em vez de repetir em laço apertado.