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
| Champ | Type | Description |
|---|---|---|
id | integer | ID de la user story |
code | string | Code lisible (ex. "US-1") |
slug | string | Identifiant slug |
title | string | Titre de la user story |
votes | integer | Nombre de votes |
additional_information | string ou null | Détails complémentaires |
acceptance_criteria | string ou null | Critères d'acceptation (Markdown) |
priority | object ou null | Niveau de priorité avec id, slug, title, color |
epic | object ou null | Epic associée |
company | object | Slug de l'entreprise |
project | object | Détails du projet |
stats.tasks | object | Statistiques des tâches : total, closed, open |
user | object | Créateur de la user story |
users | array | Utilisateurs assignés |
created_at | object | Horodatage de création |
Notes
- Le champ
acceptance_criteriaest au format Markdown. Parsez-le correctement si vous l'affichez. stats.tasksindique la progression des tâches liées à cette user story.prioritypeut êtrenullsi aucune priorité n'est définie.
Associé
- User Story Mise à Jour —
user-stories.update - User Story Votée —
user-stories.vote - User Story Supprimée —
user-stories.destroy