GitScrum / Docs

User Story Criada

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

Disparado quando uma nova user story é criada no projeto.

  • Evento: user-stories.store
  • Categoria: User Stories
  • Gatilhos: Criar uma user story via painel de user stories

Payload

O payload contém o recurso completo da user story via UserStoryResource:

{
  "id": 10,
  "code": "US-10",
  "slug": "user-login-flow",
  "title": "As a user, I want to log in with OAuth",
  "votes": 0,
  "additional_information": "<p>Support Google and GitHub OAuth providers.</p>",
  "additional_information_mention": null,
  "acceptance_criteria": "<p>Given a valid OAuth token, the user is authenticated.</p>",
  "acceptance_criteria_mention": null,
  "priority": {
    "id": 2,
    "title": "High",
    "color": "#EF4444",
    "total": 5
  },
  "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": 5,
    "worked_hours": 0,
    "total_tasks": 3,
    "closed_tasks": 0,
    "percentage": 0,
    "comments": 0
  },
  "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
    }
  },
  "users": [],
  "created_at": {
    "date_for_humans": "Just now",
    "iso8601": "2026-02-06T14:30:00+00:00",
    "timestamp": 1738852200
  }
}

Referência de Campos

CampoTipoDescrição
idintegerID da user story
codestringCódigo da user story (ex: US-10)
slugstringIdentificador amigável para URL
titlestringTítulo da user story
votesintegerContagem de votos
additional_informationstring ou nullDetalhes extras (HTML)
acceptance_criteriastring ou nullCritérios de aceitação (HTML)
priorityobject ou nullPrioridade com id, title, color, total
epicobject ou nullÉpico com uuid, title, color, stats, user, created_at
companyobjectslug e name do workspace
projectobjectslug e name do projeto
statsobjectContagens: storypoints, workedhours, totaltasks, closedtasks, percentage, comments
userobjectCriador
usersarrayUsuários das tarefas atribuídas
created_atobjectTimestamp de criação

Relacionado