Modify a user story
PUT
/api/initiatives/SHO-MJXR/storyMap/card/US-87Update the details of the card identified by ID 1238 in the story map of the initiative with external key SHO-MJXR.
Request
Body Params application/json
summary
string
optional
color
string
optional
progress
string
optional
backlog
boolean
optional
description
string
optional
businessGoal
string
optional
persona
array [object {2}]
optional
personaValue
string
optional
personaId
integer
optional
teamId
null
optional
userId
array[integer]
optional
startDate
string
optional
endDate
string
optional
tags
string
optional
urls
array [object {1}]
optional
url
string
optional
jiraId
string
optional
jiraKey
string
optional
externalProgress
string
optional
epicId
integer
optional
featureId
integer
optional
storyPoint
string
optional
remainingTime
string
optional
kpis
array[string]
optional
files
array [object {1}]
optional
file
object
optional
Example
{
"summary": "As a product manager, I want to implement personalized onboarding emails based on user behavior to improve user retention rates",
"color": "#4784fc",
"progress": "to-do",
"backlog": true,
"description": "<ul><li><strong>Acceptance Criteria:</strong><ul><li>Develop a system to track user actions and behaviors within the first week of signup.</li><li>Design email templates that dynamically adjust content based on user activity.</li><li>Implement A/B testing for different email variants to optimize engagement.</li><li>Integrate analytics to measure the impact of personalized onboarding emails on user retention.</li></ul></li></ul><p> </p>",
"businessGoal": "This user story aims to enhance user engagement and retention by leveraging personalized communication strategies.",
"persona": [
{
"personaValue": "Product Managers (Strategy Oriented)",
"personaId": 996
},
{
"personaValue": "Product Managers (Strategy Oriented)",
"personaId": 996
},
{
"personaValue": "Product Managers (Strategy Oriented)",
"personaId": 996
}
],
"teamId": null,
"userId": [],
"startDate": "2024-06-30T18:30:00.000Z",
"endDate": "2024-07-18T18:30:00.000Z",
"tags": "[\"Product management\",\"engagement\"]",
"urls": [
{
"url": "https://example.com"
},
{
"url": "https://example.com"
},
{
"url": "https://example.com"
}
],
"jiraId": "",
"jiraKey": "",
"externalProgress": "",
"epicId": 0,
"featureId": 0,
"storyPoint": "7",
"remainingTime": "3",
"kpis": [],
"type": "userstory",
"progressPercentage": 0,
"firstChild": "features",
"files": [
{
"file": {
"id": 3246,
"path": "1346/1116/16802/onboarding.png",
"size": "0.00",
"sizeType": "kb",
"userId": 17355,
"subscriptionId": 1346,
"initiativeId": 1116,
"usedAt": "userstory",
"description": null,
"name": "onboarding.png",
"artifactId": 1238,
"status": "active",
"createdAt": "2024-07-12T03:39:36.000Z",
"updatedAt": "2024-07-12T03:39:36.000Z",
"file": "https://prodeasy.s3.eu-central-1.amazonaws.com/1346/1116/16802/onboarding.png"
}
},
{
"file": {
"id": 3246,
"path": "1346/1116/16802/onboarding.png",
"size": "0.00",
"sizeType": "kb",
"userId": 17355,
"subscriptionId": 1346,
"initiativeId": 1116,
"usedAt": "userstory",
"description": null,
"name": "onboarding.png",
"artifactId": 1238,
"status": "active",
"createdAt": "2024-07-12T03:39:36.000Z",
"updatedAt": "2024-07-12T03:39:36.000Z",
"file": "https://prodeasy.s3.eu-central-1.amazonaws.com/1346/1116/16802/onboarding.png"
}
},
{
"file": {
"id": 3246,
"path": "1346/1116/16802/onboarding.png",
"size": "0.00",
"sizeType": "kb",
"userId": 17355,
"subscriptionId": 1346,
"initiativeId": 1116,
"usedAt": "userstory",
"description": null,
"name": "onboarding.png",
"artifactId": 1238,
"status": "active",
"createdAt": "2024-07-12T03:39:36.000Z",
"updatedAt": "2024-07-12T03:39:36.000Z",
"file": "https://prodeasy.s3.eu-central-1.amazonaws.com/1346/1116/16802/onboarding.png"
}
}
]
}
Request samples
Responses
Success(200)
HTTP Code: 200
Content Type : JSONapplication/json
Data Schema
success
boolean
required
message
string
required
data
object
required
Example
{
"success": true,
"message": "Card has been edited",
"data": {}
}
Modified at 3 months ago