Shorter Loop API Documentation
API ReferencesRelease NotesHelp CenterKnowledge Base
API ReferencesRelease NotesHelp CenterKnowledge Base
Sign In
  1. Epics
  • Getting started
    • Welcome to the Shorter Loop API Portal
    • Authentication
    • Base URL
    • 2 way Jira Integration
    • Create webhook in Shorter Loop
  • Metrics
    • Create a Key Performance Indicator (KPI)
      POST
    • Update the Key Performance Indicator (KPI)
      PUT
    • Retrieve KPIs not linked to specific product backlog items
      GET
    • Insert KPI's records (Body JSON Payload)
      POST
    • Insert KPI's records (Upload CSV)
      POST
    • Insert KPI's records (Upload JSON)
      POST
  • Idea manager
    • Feedback Collection
      • Create idea and issue
      • Retrieves a list of categories
      • Modify feedback item
      • Removes a feedback item
      • Upvote or downvote a work item
      • Retrieve a feedback item
      • Get comments for a feedback item.
      • Reply to a comment
      • Modify a comment
      • Bulk create feedback items: CSV and JSON
    • Segments
      • Retrieves a list of segments without users
      • Create segment
      • Modify a segment
      • Removes a segment
      • Bulk create users to a segment
      • Manage user segments: move or remove
      • Retrieve segments with users
      • Retrieve segment with users
      • Import Users (CSV/JSON)
      • Sending email to segment members
      • Sending email to selected idm members
    • Bulk create idea manager members
      POST
    • Import Users (CSV/JSON) in IDM
      POST
    • Bulk re-invite in IDM
      PUT
  • Backlog Management
    • Epics
      • Create a new epic
        POST
      • Modify an epic
        PUT
      • Retrieve details of the epic
        GET
      • Removes the epic
        DELETE
    • Features
      • Create a new feature
      • Modify a feature
      • Retrieve details of the feature
      • Removes the feature
    • User stories
      • Create a new user story
      • Modify a user story
      • Retrieve user story
      • Removes the user story
    • Assets
      • Attaches files to the workitem
      • Removes an asset
      • Retrieve attachments for the backlog workitem with ID
    • Product Tags
      • Retrieves tags for initiative
    • Teams
      • Get teams and members for product
    • Personas
      • Retrieve personas associated with initiative
    • Get whole backlog tree
      GET
  • Strategy Board
    • Experiment
      • Create a new experiemnt variant
    • Solutions
      • Versions
        • Storymap versions api documentation
        • Create a version
        • Update version
        • Removes a version
        • Retrieve versions
      • Get all storymaps for solution
  • Persona Board V2
    • Segments
      • Permanently deletes a segment
      • Creates a new option
      • Retrieve a list of segments
      • Retrieve a segment
      • Create a segment
      • Removes a segment
      • Removes a segment option
      • Detaches a segment from the persona
      • Update segment option
    • Custom fields
      • Removes a custom field
      • Retrieve a list of custom fields
      • Retrieve a custom field
      • Create a custom field
      • Removes a custom field option
      • Detaches a custom field from persona
      • Retrieve custom fields excluding persona
      • Creates a new option
      • Permanently deletes a custom field
      • Update custom field
      • Update custom field option
      • Attach a custom field to a persona
    • Create opportunities from summary
    • Retrieve notes
    • Retrieve persona
    • Retrieve experiments for Persona
    • Create
    • Retrieve
  • DocsHub
    • Retrieve categories with templates
    • Retrieve a template based on category
    • Create copy of template while using template
  1. Epics

Retrieve details of the epic

GET
/api/initiatives/SHO-MJXR/epics/EP-41
The GET /api/initiatives/SHO-MJXR/epics/EP-41 endpoint retrieves detailed information about the epic identified by EP-41 within the initiative identified by SHO-MJXR.
Notes:
Ensure that a valid authentication token is provided in the request headers.
Ensure that you provide right epic external key

Request

Query Params

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.shorterloop.com/api/initiatives/SHO-MJXR/epics/EP-41?externalKey=EP-41' \
--header 'Authorization;' \
--header 'initiativeId;'

Responses

🟢200Success
application/json
Body

Example
{
    "success": true,
    "data": {
        "id": 1087,
        "summary": "Enhance User Engagement and Retention",
        "backlog": true,
        "description": "<p>Improve user engagement and retention metrics through targeted feature enhancements and optimizations across the platform.</p><p>&nbsp;</p>",
        "externalKey": "EP-41",
        "color": "#ffb64f",
        "estimate": "60",
        "score": "1.6666666666666667",
        "businessValue": "100",
        "order": 19,
        "progress": "review",
        "externalProgress": "",
        "jiraId": "",
        "jiraKey": "",
        "jiraSelf": null,
        "jiraParentId": "",
        "teamId": null,
        "businessGoal": "Increase Monthly Active Users (MAUs) by 20% within the next fiscal year.",
        "tags": "[\"Epic\",\"User engagement\"]",
        "urls": [
            {
                "url": "https://example.com"
            },
            {
                "url": "https://example.com"
            }
        ],
        "persona": "[{\"personaValue\":\"UX Researchers\",\"personaId\":999},{\"personaValue\":\"Engineers\",\"personaId\":1000}]",
        "userId": [
            17355
        ],
        "startDate": "2024-06-30T18:30:00.000Z",
        "endDate": "2024-07-30T18:30:00.000Z",
        "roadmapId": 0,
        "businessObjectiveId": 0,
        "swimlaneId": 0,
        "timeBoxPlanningId": 0,
        "subTimeBoxPlanningId": 0,
        "storyMapId": 0,
        "features": [],
        "userStories": [],
        "user": [],
        "progressPercentage": 0,
        "kpis": [
            {
                "id": 7557,
                "title": "Employee retention",
                "benchmark": "50.00",
                "benchmarkUnit": "%",
                "benchmarkType": "MORE",
                "initiativeId": 1116,
                "dueDate": null,
                "statement": "",
                "createdAt": "2024-07-12T02:24:12.000Z",
                "visualization": false,
                "dashboardVisualization": true,
                "order": 11,
                "kpiId": 7557,
                "name": "Employee retention",
                "value": "",
                "kpi_revisions": []
            },
            {
                "id": 7558,
                "title": "Churn",
                "benchmark": "30.00",
                "benchmarkUnit": "%",
                "benchmarkType": "MORE",
                "initiativeId": 1116,
                "dueDate": null,
                "statement": "",
                "createdAt": "2024-07-12T02:41:32.000Z",
                "visualization": false,
                "dashboardVisualization": true,
                "order": 12,
                "kpiId": 7558,
                "name": "Churn",
                "value": "",
                "kpi_revisions": []
            },
            {
                "id": 7559,
                "title": "hello",
                "benchmark": "0.00",
                "benchmarkUnit": "",
                "benchmarkType": "",
                "initiativeId": 1116,
                "dueDate": null,
                "statement": "",
                "createdAt": "2024-07-12T02:44:56.000Z",
                "visualization": false,
                "dashboardVisualization": true,
                "order": 13,
                "kpiId": 7559,
                "name": "hello",
                "value": "0",
                "kpi_revisions": []
            },
            {
                "id": 7563,
                "title": "Increase customer retention",
                "benchmark": "40.00",
                "benchmarkUnit": "%",
                "benchmarkType": "MORE",
                "initiativeId": 1116,
                "dueDate": "2024-07-12T18:30:00.000Z",
                "statement": "11",
                "createdAt": "2024-07-12T02:51:29.000Z",
                "visualization": true,
                "dashboardVisualization": true,
                "order": 15,
                "kpiId": 7563,
                "name": "Increase customer retention",
                "value": "11",
                "kpi_revisions": [
                    {
                        "id": 3275,
                        "createdAt": "2024-07-12T02:51:29.000Z",
                        "value": "11.00"
                    }
                ]
            },
            {
                "id": 7564,
                "title": "Increase customer retention",
                "benchmark": "40.00",
                "benchmarkUnit": "%",
                "benchmarkType": "MORE",
                "initiativeId": 1116,
                "dueDate": "2024-07-12T18:30:00.000Z",
                "statement": "11",
                "createdAt": "2024-07-12T02:54:01.000Z",
                "visualization": true,
                "dashboardVisualization": true,
                "order": 16,
                "kpiId": 7564,
                "name": "Increase customer retention",
                "value": "11",
                "kpi_revisions": [
                    {
                        "id": 3276,
                        "createdAt": "2024-07-12T02:54:01.000Z",
                        "value": "11.00"
                    }
                ]
            }
        ]
    }
}
Modified at 2024-07-12 02:15:29
Previous
Modify an epic
Next
Removes the epic
Built with