Shorter Loop API Documentation
API ReferencesRelease NotesHelp CenterKnowledge Base
API ReferencesRelease NotesHelp CenterKnowledge Base
Sign In
  1. Metrics
  • 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
      • Modify an epic
      • Retrieve details of the epic
      • Removes the epic
    • 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. Metrics

Insert KPI's records (Upload CSV)

POST
/api/initiatives/{{product_external_key}}/kpi/{{kpi_external_key}}/insert-kpi-records
This API endpoint allows users to insert Key Performance Indicators (KPIs) by uploading a CSV file. This request supports only the insertion of new KPI records via the CSV file upload.

Request

Query Params

Header Params

Body Params multipart/form-data

Request 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 -g --request POST 'https://api.shorterloop.com/api/initiatives/{{product_external_key}}/kpi/{{kpi_external_key}}/insert-kpi-records?product_external_key=MGMT&kpi_external_key=KPI-46' \
--header 'Authorization;' \
--header 'initiativeId;' \
--form 'metrics=@"cmMtdXBsb2FkLTE3MTYzODAxOTUwOTQtMg==/csv-sample.csv"'

Responses

🟢201Created
application/json
Body

Example
{
    "success": true,
    "message": "Records inserted successfully. 2 out of 9 KPI records were not inserted due to incorrect entries in the provided data.",
    "data": {
        "id": 1162,
        "title": "Matrics sample",
        "externalKey": "KPI-15",
        "benchmark": "334455.00",
        "visualization": true,
        "benchmarkUnit": "INR",
        "benchmarkType": "MORE",
        "initiativeId": 1139,
        "dueDate": "2024-06-29T18:30:00.000Z",
        "dashboardVisualization": true,
        "statement": "4455",
        "createdAt": "2024-05-16T06:48:10.000Z",
        "kpi_revisions": [
            {
                "id": 1008,
                "createdAt": "2024-05-16T06:53:19.000Z",
                "value": "148.00"
            },
            {
                "id": 1010,
                "createdAt": "2024-05-16T06:53:19.000Z",
                "value": "33.99"
            },
            {
                "id": 1011,
                "createdAt": "2024-05-16T06:53:19.000Z",
                "value": "14.00"
            },
            {
                "id": 1013,
                "createdAt": "2024-05-16T06:53:19.000Z",
                "value": "18.00"
            },
            {
                "id": 1002,
                "createdAt": "2024-05-16T06:49:36.000Z",
                "value": "12.00"
            },
            {
                "id": 1003,
                "createdAt": "2024-05-16T06:49:36.000Z",
                "value": "14.00"
            },
            {
                "id": 1004,
                "createdAt": "2024-05-16T06:49:36.000Z",
                "value": "130.00"
            },
            {
                "id": 1006,
                "createdAt": "2024-05-16T06:49:36.000Z",
                "value": "33.99"
            },
            {
                "id": 1007,
                "createdAt": "2024-05-16T06:49:36.000Z",
                "value": "22.89"
            },
            {
                "id": 999,
                "createdAt": "2024-05-16T06:49:12.000Z",
                "value": "148.00"
            },
            {
                "id": 1001,
                "createdAt": "2024-05-16T06:49:12.000Z",
                "value": "33.99"
            },
            {
                "id": 996,
                "createdAt": "2024-05-16T06:48:52.000Z",
                "value": "130.00"
            },
            {
                "id": 998,
                "createdAt": "2024-05-16T06:48:52.000Z",
                "value": "33.99"
            },
            {
                "id": 995,
                "createdAt": "2024-05-16T06:48:10.000Z",
                "value": "4455.00"
            },
            {
                "id": 997,
                "createdAt": "2024-05-11T07:38:05.000Z",
                "value": "223.09"
            },
            {
                "id": 1014,
                "createdAt": "2024-04-04T07:38:05.000Z",
                "value": "23.90"
            },
            {
                "id": 1012,
                "createdAt": "2024-03-10T07:38:05.000Z",
                "value": "223.09"
            },
            {
                "id": 1000,
                "createdAt": "2024-03-01T07:38:05.000Z",
                "value": "223.09"
            },
            {
                "id": 1005,
                "createdAt": "2024-03-01T07:38:05.000Z",
                "value": "223.09"
            },
            {
                "id": 1009,
                "createdAt": "2024-02-21T07:38:05.000Z",
                "value": "22.00"
            }
        ]
    }
}
🟠400Invalid Input
🟠404Record not found
Modified at 2024-07-12 02:07:57
Previous
Insert KPI's records (Body JSON Payload)
Next
Insert KPI's records (Upload JSON)
Built with