Comentar, editar e arquivar

Atualizado em 17 de outubro de 2026

Considerações

Ler comentários exige tasks:read; criar, editar e arquivar exigem tasks:write.
Como no painel, quem pode ver a tarefa pode editar e arquivar qualquer comentário dela, não só os próprios.
Criar, editar e arquivar ficam no histórico da tarefa, igual ao painel.
O PATCH é parcial: o campo que não vier fica como está. Comentário arquivado não se edita (409 invalid_transition).
Arquivar tira o comentário da listagem; arquivar de novo devolve o mesmo comentário, sem outro registro.
Comentário de outra tarefa responde 404.
A listagem vem do mais antigo ao mais recente, no envelope paginado, só com os comentários ativos.

Referência

GET /tasks/{task}/comments na Referência da API POST /tasks/{task}/comments na Referência da API PATCH /tasks/{task}/comments/{comment} na Referência da API POST /tasks/{task}/comments/{comment}/archive na Referência da API

Como fazer

Liste os comentários da tarefa:

cURL

curl "$MICORE_BASE_URL/tasks/512/comments" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Crie um comentário:

cURL

curl -X POST "$MICORE_BASE_URL/tasks/512/comments" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: request-2026-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Cliente retornou a ligação, aguardando proposta."
}'

Edite o texto:

cURL

curl -X PATCH "$MICORE_BASE_URL/tasks/512/comments/9001" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: request-2026-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Cliente aprovou a proposta."
}'

Arquive o comentário:

cURL

curl -X POST "$MICORE_BASE_URL/tasks/512/comments/9001/archive" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: request-2026-0001"

Resposta

A criação responde 201; a edição e o arquivamento, 200, com o comentário:

Resposta · 200

{
  "data": {
    "id": 9001,
    "task_id": 512,
    "text": "Cliente aprovou a proposta.",
    "task_progress": "doing",
    "author": { "id": 7, "name": "Ana Souza" },
    "archived": false,
    "mentions": [],
    "created_at": "2026-10-17T10:00:00-03:00",
    "updated_at": "2026-10-17T11:30:00-03:00"
  }
}

Precisa de ajuda?Use o request ID e abra um chamado no miCore se encontrar uma divergência.