GitScrum / Docs

User Story Créée

Référence de payload du webhook pour l'événement user-stories.store, déclenché lorsqu'une nouvelle user story est créée.

Déclenché lorsqu'une nouvelle user story est créée dans un projet.

  • Événement : user-stories.store
  • Catégorie : User Stories
  • Déclencheurs : Création d'une user story dans le tableau des user stories

Payload

Le payload contient la ressource user story complète via UserStoryResource :

{
  "id": 1,
  "code": "US-1",
  "slug": "improve-mobile-ux",
  "title": "Improve Mobile UX",
  "votes": 0,
  "additional_information": "Users report difficulty navigating on mobile devices",
  "acceptance_criteria": "- Navigation is thumb-friendly\n- All actions reachable within 2 taps",
  "priority": {
    "id": 2,
    "slug": "high",
    "title": "High",
    "color": "#FF6B35",
    "position": 2,
    "default": false
  },
  "epic": null,
  "company": {
    "slug": "acme-corp"
  },
  "project": {
    "slug": "web-platform",
    "name": "Web Platform",
    "logo": "https://logo.url/project.png",
    "visibility": {
      "is_private": 1,
      "title": "Private"
    },
    "recurring": true,
    "owner": { ... }
  },
  "stats": {
    "tasks": {
      "total": 0,
      "closed": 0,
      "open": 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-06T15:00:00+00:00",
    "timestamp": 1738854000
  }
}

Référence des Champs

ChampTypeDescription
idintegerID de la user story
codestringCode lisible (ex. "US-1")
slugstringIdentifiant slug
titlestringTitre de la user story
votesintegerNombre de votes
additional_informationstring ou nullDétails complémentaires
acceptance_criteriastring ou nullCritères d'acceptation (Markdown)
priorityobject ou nullNiveau de priorité avec id, slug, title, color
epicobject ou nullEpic associée
companyobjectSlug de l'entreprise
projectobjectDétails du projet
stats.tasksobjectStatistiques des tâches : total, closed, open
userobjectCréateur de la user story
usersarrayUtilisateurs assignés
created_atobjectHorodatage de création

Notes

  • Le champ acceptance_criteria est au format Markdown. Parsez-le correctement si vous l'affichez.
  • stats.tasks indique la progression des tâches liées à cette user story.
  • priority peut être null si aucune priorité n'est définie.

Associé