GitScrum / Docs

Tarefa Atualizada

Referência de payload do webhook para o evento issues.update, disparado quando uma tarefa é modificada.

Disparado quando qualquer campo de uma tarefa é modificado.

  • Evento: issues.update
  • Categoria: Tarefas
  • Gatilhos: Edição de título, descrição, prioridade, esforço, tipo, data de vencimento, labels ou qualquer outro campo da tarefa

Payload

A atualização principal envia o recurso completo da tarefa (mesma estrutura de issues.store).

No entanto, ações de atualização específicas enviam payloads simplificados:

Atualização de Estimativa

Quando o percentual de progresso é alterado:

{
  "estimative": 75
}

Alternância de Conclusão

Quando uma tarefa é marcada como concluída ou não concluída:

{
  "done": true,
  "user": {
    "id": 1,
    "uuid": "user-uuid-123",
    "name": "Jane Smith",
    "username": "janesmith",
    "avatar": "https://avatar.url/jane.jpg",
    "headline": "Lead Developer",
    "location": "Porto, Portugal",
    "timezone_name": "Europe/Lisbon",
    "language": "en",
    "created_at": {
      "date_for_humans": "1 year ago",
      "iso8601": "2025-01-15T10:00:00+00:00",
      "timestamp": 1736935200
    }
  }
}

Quando desfeita, done é false e user é null.

Atualização Completa

Quando campos como título, descrição, prioridade, esforço, tipo, data de vencimento ou labels são alterados, o payload completo do BoardTaskResource é enviado (idêntico a issues.store).

Notas

  • O formato do payload varia dependendo de qual ação de atualização disparou o evento.
  • O recurso completo da tarefa é enviado para a maioria das alterações de campo.
  • Payloads parciais (estimativa, alternância de conclusão) contêm apenas os dados alterados.
  • O payload sempre reflete o estado após a atualização.

Relacionado