GitScrum / Docs

User Story Actualizada

Referencia de payload del webhook para el evento user-stories.update, disparado cuando una user story es actualizada.

Disparado cuando una user story es actualizada.

  • Evento: user-stories.update
  • Categoría: User Stories
  • Gatillos: Editar cualquier campo de una user story (título, descripción, prioridad, criterios de aceptación, épica)

Payload

El payload contiene el recurso completo de user story, idéntico en estructura 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
  }
}

Referencia de Campos

Consulta la referencia completa de campos en User Story Creada. La estructura del payload es idéntica — todos los campos del UserStoryResource se incluyen sin importar qué campo cambió.

Notas

  • El recurso completo de user story siempre se envía, no solo los campos modificados.
  • El objeto stats refleja los conteos actuales al momento del evento.
  • priority y epic pueden ser null si no están asignados.

Relacionado