Visão geral
Tarefas do ticket
Seção intitulada “Tarefas do ticket”Tarefas de um ticket: a lista de afazeres que o atendimento vai marcando. Toda requisição exige o cabeçalho Authorization: Bearer <chave de API>.
O ticket da rota é sempre resolvido na empresa da chave antes de qualquer outra verificação: um ticket de outra empresa, ou inexistente, responde 404 not_found, e uma tarefa que não pertence ao ticket da rota responde o mesmo.
agentId é obrigatório ao criar (avulsa ou por modelo): ele é ao mesmo tempo o criador e o responsável da tarefa. O criador não é opcional no produto — é parte da chave da tabela —, e a chave de API não é uma pessoa, então quem escolhe o agente é o integrador. A escrita continua nascendo com origem API e guardando o identificador da chave no histórico do ticket.
Ler continua permitido em ticket na lixeira; escrever, não (422 ticket_deleted). Em ticket concluído ou fechado todas as operações de tarefa continuam permitidas, como na tela: a aba de tarefas é a única que o produto não tranca no encerramento.
Uma linha pode ser um título de grupo (groupTitle: true): um separador que organiza as tarefas abaixo dele. Um título de grupo não tem prazo, responsável, descrição nem conclusão, e enviar qualquer um desses campos junto dele responde 422 validation_failed com not_applicable — o produto os descartaria em silêncio, e esta API prefere recusar a devolver um estado diferente do que foi pedido.
deadline não tem fuso: é um valor de parede, como o agente o digita. Quem carrega instante de verdade são createdAt e updatedAt, carimbos do servidor — e eles são nulos em tarefa anterior a esta API, que nunca recebeu carga retroativa.