Pedir e aprovar novo prazo

Considerações

• Vale para quadros com lock_due_date ligado (veja "Criar e editar um quadro") e tarefas que já têm prazo final. Nesses quadros, PATCH /tasks/{task} com outro date_end responde 403 permission_denied para quem não é gestor do quadro nem administrador de Quadros.
• Pedir exige tasks:write e Idempotency-Key; envie date (ano-mês-dia, diferente do prazo atual) e reason. Sem motivo ou com a mesma data, 422.
• A tarefa tem no máximo um pedido pendente: repetir o seu troca a data e o motivo; pendente de outra pessoa responde 409 invalid_transition. O gestor e o administrador não pedem: mudam direto pelo PATCH, com deadline_reason para registrar o motivo.
• Aprovar e recusar exigem que o usuário da credencial seja o gestor do quadro ou administrador de Quadros (senão 403 permission_denied). Aprovado, o prazo final da tarefa passa a ser a data pedida, com o motivo no histórico; recusado, nada muda. Quem pediu é avisado no sino, com a note se houver.
• Só quem pediu cancela, e só o pedido pendente. Decidir ou cancelar um pedido que não está pendente responde 409 invalid_transition.
• GET /tasks/{task}/deadline-requests lista os pedidos da tarefa, do mais recente ao mais antigo, com status pending, approved, refused ou canceled.

Referência

Como fazer

Quem executa pede o novo prazo:

curl -X POST "$MICORE_BASE_URL/tasks/512/deadline-requests" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: request-2026-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2026-11-27",
    "reason": "Aguardando o material do cliente."
}'

O gestor do quadro aprova (ou recusa em /refuse), com uma observação opcional:

curl -X POST "$MICORE_BASE_URL/deadline-requests/31/approve" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "note": "Ok, sem impacto na entrega."
}'

Resposta

O pedido responde 201 e fica pendente:

{
  "data": {
    "id": 31,
    "task_id": 512,
    "board_id": 4,
    "requested_by": 12,
    "current_date_end": "2026-11-20",
    "proposed_date_end": "2026-11-27",
    "reason": "Aguardando o material do cliente.",
    "status": "pending",
    "decided_by": null,
    "decided_at": null,
    "decision_note": null,
    "created_at": "2026-11-12T10:00:00-03:00"
  }
}

Aprovado, o status vira approved, com decided_by, decided_at e decision_note, e o date_end da tarefa passa a ser a data pedida.