GitScrum / Docs

User Story Atualizada

Referência de payload do webhook para o evento user-stories.update, disparado quando uma user story é atualizada.

Disparado quando uma user story é atualizada.

  • Evento: user-stories.update
  • Categoria: User Stories
  • Gatilhos: Editar qualquer campo de uma user story (título, descrição, prioridade, critérios de aceitação, épico)

Payload

O payload contém o recurso completo da user story, idêntico em estrutura a user-stories.store:

{
  "id": 10,
  "code": "US-10",
  "slug": "user-login-flow",
  "title": "As a user, I want to log in with OAuth",
  "votes": 3,
  "additional_information": "<p>Support Google, GitHub, and Microsoft OAuth providers.</p>",
  "additional_information_mention": null,
  "acceptance_criteria": "<p>Given a valid OAuth token, the user is authenticated within 2 seconds.</p>",
  "acceptance_criteria_mention": null,
  "priority": {
    "id": 1,
    "title": "Critical",
    "color": "#DC2626",
    "total": 2
  },
  "epic": {
    "uuid": "epic-uuid-123",
    "title": "Authentication Module",
    "color": "#8B5CF6",
    "stats": {
      "user_stories": 8
    },
    "user": { ... },
    "created_at": {
      "date_for_humans": "2 weeks ago",
      "iso8601": "2026-01-23T10:00:00+00:00",
      "timestamp": 1737622800
    }
  },
  "company": {
    "slug": "acme-corp",
    "name": "Acme Corp"
  },
  "project": {
    "slug": "web-platform",
    "name": "Web Platform"
  },
  "stats": {
    "story_points": 13,
    "worked_hours": 8,
    "total_tasks": 5,
    "closed_tasks": 2,
    "percentage": 40,
    "comments": 7
  },
  "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": { ... }
  },
  "users": [],
  "created_at": {
    "date_for_humans": "1 hour ago",
    "iso8601": "2026-02-06T13:00:00+00:00",
    "timestamp": 1738846800
  }
}

Referência de Campos

Consulte a referência completa de campos em User Story Criada. A estrutura do payload é idêntica — todos os campos do UserStoryResource são incluídos independentemente de qual campo foi alterado.

Notas

  • O recurso completo da user story é sempre enviado, não apenas os campos alterados.
  • O objeto stats reflete as contagens atuais no momento do evento.
  • priority e epic podem ser null se não atribuídos.

Relacionado