Mencionar pessoas no comentário

Considerações

• Envie mention_user_ids ao criar (POST) ou editar (PATCH) o comentário; mention_everyone: true menciona todos os mencionáveis da tarefa.
• Mencionáveis são os mesmos do painel: quem criou, os responsáveis, quem já comentou ou agiu na tarefa, as pessoas da solicitação de origem e a equipe e o gestor do quadro. Consulte em GET /tasks/{task}/mentionable-users (escopo tasks:read).
• Ids fora dessa lista são ignorados, como no painel; confira em mentions na resposta quem foi mencionado.
• Na edição, as menções só se acrescentam: quem já estava mencionado continua e não recebe o aviso de novo.
• Para o nome aparecer destacado no texto, como no editor, use <span class="mention" data-user-id="12">@Bruno</span>. O destaque é só visual; quem é avisado é quem vier em mention_user_ids.

Referência

Como fazer

Veja quem pode ser mencionado:

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

Comente mencionando a pessoa:

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": "<p><span class=\"mention\" data-user-id=\"12\">@Bruno<\/span> pode revisar a arte?<\/p>",
    "mention_user_ids": [
        12
    ]
}'

Resposta

O comentário volta com a menção:

{
  "data": {
    "id": 9002,
    "task_id": 512,
    "text": "<p><span class=\"mention\" data-user-id=\"12\">@Bruno</span> pode revisar a arte?</p>",
    "archived": false,
    "mentions": [
      { "user": { "id": 12, "name": "Bruno Lima" }, "type": "direct", "status": "pending" }
    ],
    "created_at": "2026-11-11T09:00:00-03:00",
    "updated_at": "2026-11-11T09:00:00-03:00"
  }
}