getKRDetails

Background

This REST API meant to provide access to KR details to the current user. Users are granted as many permissions as the actual users have through their UpRaise roles.

API Details

This API will require valid authentication & will expect the user API token in the request.
Read Create User API token for more details
Base URL - <baseUrl>/rest/upraise/public/1.0/okr/keyresult/{keyResultId}
Below are the sample endpoints for this API based on which UpRaise app you are using

App name	Endpoint

App name	Endpoint
UpRaise for Employee Success	https://employee-success.upraise.io/rest/upraise/public/1.0/okr/keyresult/{keyResultId}
UpRaise People	https://people.upraise.io/rest/upraise/public/1.0/okr/keyresult/{keyResultId}

Request parameters

Key result id is needed as input in the endpoint URL.

On this page

On this page

1 Background
2 API Details
3 Request parameters
4 Sample responses and Parameter details (To do KRs)
- 4.1 Sample JSON response
- 4.2 Response parameters details
- 4.3 Sample JSON response
- 4.4 Response parameter details
5 Sample responses and Parameter details (Metric KR)
- 5.1 Sample JSON response
- 5.2 Response parameters details
- 5.3 Sample JSON response
- 5.4 Response parameters details
- 5.5 Sample JSON response
- 5.6 Response parameters details

Sample responses and Parameter details (To do KRs)

Below are samlpe JSON responses and their parameter details based on the selected progress calculation modes of the to do KR.

Sample JSON response

{
    "id": 350827,
    "key": "KR-34",
    "type": {
        "id": 1,
        "name": "To do"
    },
    "title": "Ensure 100% pass rate of automated regression tests for 80 test cases.",
    "description": "",
    "keyResultOwner": {
        "upRaiseInfo": {
            "id": 98136,
            "ownerDesignation": {
                "id": 901,
                "name": "Tester"
            },
            "ownerTeams": [
                {
                    "id": 2802,
                    "name": "Testing Team"
                },
                {
                    "id": 2805,
                    "name": "Attlasian Team"
                },
                {
                    "id": 2804,
                    "name": "Product Team"
                }
            ]
        },
        "jiraUserRestApiUrl": "<baseURL>/rest/api/2/user?accountId=6327fe4c61dbef2805bb9a62"
    },
    "startDate": "19/Mar/24",
    "dueDate": "31/Mar/24",
    "weightageInPercent": "25.0",
    "progress": {
        "percent": 0.0,
        "confidenceStatus": {
            "id": 1902,
            "name": "LAGGING"
        },
        "confidenceScore": 4.0
    },
    "progressCalculation": {
        "mode": "Manual"
    },
    "status": {
        "name": "In Progress"
    },
    "orderIndex": 3,
    "lastPunchedIn": "20/Mar/24 6:46 AM",
    "creator": {
        "id": 98136,
        "jiraUserRestApiUrl": "<baseURL>/rest/api/2/user?accountId=6327fe4c61dbef2805bb9a62"
    },
    "created": "19/Mar/24 12:51 PM",
    "modifiedBy": {
        "id": 98136,
        "jiraUserRestApiUrl": "<baseURL>/rest/api/2/user?accountId=6327fe4c61dbef2805bb9a62"
    },
    "modified": "20/Mar/24 7:01 AM",
    "customFields": [
        {
            "id": 67,
            "name": "Company Name",
            "type": "Text field (single line)",
            "textValue": "ABC Pvt. Ltd."
        },
        {
            "id": 89,
            "name": "Business Unit",
            "type": "Select list (single choice)",
            "option": {
                "id": 80,
                "name": "Financial Services"
            }
        },
        {
            "id": 90,
            "name": "Technologies Used",
            "type": "Select list (multiple choice)",
            "options": [
                {
                    "id": 83,
                    "name": "Selenium"
                },
                {
                    "id": 85,
                    "name": "Cypress"
                }
            ]
        },
        {
            "id": 81,
            "name": "Evaluatee",
            "type": "User picker (multiple select)",
            "userValues": [
                {
                    "id": 98136,
                    "jiraUserRestApiUrl": "<baseURL>/rest/api/2/user?accountId=6327fe4c61dbef2805bb9a62"
                },
                {
                    "id": 98147,
                    "jiraUserRestApiUrl": "<baseURL>/rest/api/2/user?accountId=63da09ac010d35637970cff8"
                }
            ]
        },
        {
            "id": 88,
            "name": "Remarks",
            "type": "Text field (multiple line)",
            "textValue": "Good"
        }
    ],
    "isAbandoned": false,
    "isArchived": false,
    "watchers": [
        {
            "upRaiseInfo": {
                "id": 98136,
                "ownerDesignation": {
                    "id": 901,
                    "name": "Tester"
                }
            },
            "jiraUserRestApiUrl": "<baseURL>/rest/api/2/user?accountId=6327fe4c61dbef2805bb9a62"
        }
    ],
    "parentArrayive": {
        "id": 131359,
        "key": "OBJ-13",
        "ArrayiveApiUrl": "<baseURL>/rest/upraise/public/1.0/okr/Arrayive/131359"
    },
    "krActions": [
        {
            "linkId": 40411,
            "key": "TP-17",
            "type": {
                "id": 0,
                "name": "Jira Issue"
            },
            "issueId": 10016,
            "jiraIssueRestApiUrl": "<baseURL>/rest/api/2/issue/TP-17"
        },
        {
            "linkId": 40412,
            "type": {
                "id": 1,
                "name": "Jql"
            },
            "title": "JQL for tracking automation progress",
            "jql": "project = TP AND status = Done"
        }
    ],
    "dateTimeFormat": "d/MMM/yy h:mm a",
    "dateFormat": "d/MMM/yy"
}

Response parameters details

Parent	Parameter	Type	Description	Possible values

Parent	Parameter	Type	Description	Possible values
	id		KR id in UpRaise	12,45,78, etc
	key		KR key in UpRaise	KR-12, KR-45, KR-78, etc
	type	Array	This array consists of details about KR types available in UpRaise that are relevant to the given KR ID.	id name
type	id	Number	Key result type id.	1,2
type	name	String	Key result name in UpRaise.	Metric Todo Currently APIs do nit support for Jira issue KR and Jira issue KR via (JQL).
	title	String	KR title	Increase CSAT rate from 60%-70% Complete Jira administration certification by end of this year
	description	String	Key result description.	This KR is meant to improve our CSAT rate. We will take necessary actions for the same…..so on.
	keyResultOwner	Array	This array consists of details about KR owner.
keyResultOwner	upRaiseInfo	String	This parameter contains user’s information	All the parameters related to user info like id, designation, team, etc.
upRaiseInfo	id	Number
upRaiseInfo	ownerDesignation	String	Details of KR owner’s designation	id name
ownerDesignation	id	Number	KR Owner’s designation id	1, 2, 3, 4, etc.
ownerDesignation	name	String	KR Owner’s designation	Sales Manager QA lead, etc.
upRaiseInfo	ownerTeams	String	KR Owner’s details	id name
ownerTeams	id	Number	KR owner’s team id	1, 2023, 26, etc.
ownerTeams	name	String	KR owner’s team name	Sales, Operations, etc.
	jiraUserRestApiUrl	Array	<baseURL>/rest/api/2/user?accountId=6327fe4c61dbef2805bb9a62
	startDate	String	KR start date
	endDate	String	KR end date
	weightageInPercent	Number	KR weightage %	25%, 50%, etc.
	progress	Array	This array consists of details about KR progress.	percent confidenceStatus confidenceScore
progress	percent	Number	This returns the current progress of the key result.	10%, 20%, 23.55%, etc.
percent	confidenceStatus	String	KR confidence status	At risk, On track, etc.
	id	Number	Confidence status type id in UpRaise	1,2,3,4,5, etc
	name	String	Confidence display name in UpRaise	On track Lagging At risk Not applicable Not available (First three confidence statuses are customizable and can be anything as per user requirements, last two are system default)
percent	confidenceScore	Number	Any number from 0-10. Only non-decimal numbers.	0-4 5-7 8-10
	progressCalculation	Array	This array consists of details about KR progress calculation type	mode
progressCalculation	mode	String	This defines the selected KR progress calculation mode	Manual Other Key results
	status	Array	This arry consists of details about KR status	name
status	name	String	Name of the KR status when mode of current KR is manual	Pending In progress Complete
	orderIndex	Number	Priority of the current key result as compared to other KRs under its parent Arrayive.	1, 2, 3, 4, etc.
	lastPunchedIn	String	Last punch in date and time of the KR	20/Mar/24 6:46 AM
	creator	Array	This array consists of details about user who created the KR	id jiraUserRestApiUrl
creator	id	Number	UpRaise user ID of the the KR creator	1, 23, etc.
creator	jiraUserRestApiUrl	String	Jira user Rest API URL	<baseURL>/rest/api/2/user?accountId=6327fe4c61dbef2805bb9a62
	created	Date	Date and time when KR is created	19/Mar/24 12:51 PM
	modifiedBy	String	This Array consists of details about user who modified the KR	id jiraUserRestApiUrl
modifiedBy	id	Number	UpRaise user ID who modified KR	1, 2, 3, 4, etc.
modifiedBy	jiraUserRestApiUrl	String	Jira User API URL who modified the KR	<baseURL>/rest/api/2/user?accountId=6327fe4c61dbef2805bb9a62
	modified	Array	Date when KR is modified	20/Mar/24 7:01 AM
	customFields	Array	This array consists of details about custom fields associated with KR based on the progress calculation setup	id name type option id name userValues id jiraUserRestApiUrl numberValue
customFields	id		Id of the custom field	1, 2, 3, 4, etc.
customFields	name		Name of the custom field	Story points, time spent, etc.
customFields	type	String	The type of selected custom field	Type parameter is to define different types of custom fields - Text field (single line) Text feild (multiline) Select list (single choice) Select list (multiple choice) User picker (Single select) User picker (Multiple select) Numeric Date picker
customFields	textValue	String	This shows the actual text values of the text field type custom fields	Any text value in the field
customFields	numberValue	Number	This shows the actual number values of the number field type custom fields	Any numeric value in the field
customFields	options	String	Multiple options in case of field types like multi-select/multi-user	Any text or numeric options under the multi select fields
options	id	Number	Id of the given options	1, 2, 3, 4, etc.
options	name	String	Name of the options	Option A Option B Option C Option D
	isAbandoned	String	This defines whether KR is Abandoned	True False
	isArchived	String	This defines whether KR is Archived	True False
	Watchers	Array	This array consists of details about KR watchers	UserInfo id ownerDesignation id name jiraUserRestApiUrl
Watchers	userInfo	String	This consists all details of the user who is watching KR	id ownerDesignation id name jiraUserRestApiUrl
userInfo	id	Number	Id of the user who is watching KR	1, 2, 3, 4, etc.
watchers	ownerDesignation	String	Details of KR watcher’s designation	id name
ownerDesignation	id	Number	Designation id of the user who is watching KR	1, 2, 3, 4, etc.
ownerDesignation	name	String	Designation of the user who is watching KR	CSM Support Manager
watchers	jiraUserRestApiUrl	String	Jira user API URL of the user who is watchimg KR	<baseURL>/rest/api/2/user?accountId=6327fe4c61dbef2805bb9a62
	parentArrayive	Array	This array consists all details of the parent Arrayive of the KR	id key ArrayiveApiUrl
parentArrayive	id	Number	Id of the parent Arrayive	1, 23415, 2324, 56, etc.
parentArrayive	key	String	UpRaise key of the parent Arrayive	obj-1, obj-2, obj-3, obj-4, etc.
parentArrayive	objectiveApiUrl	String	API URL of the parent objective	<baseURL>/rest/upraise/public/1.0/okr/objective/131359
	krActions	Array	This array consits all details of the KR actions within current KR	linkId key type id name issueId title jql
krActions	linkeid	Number	Jira issue linked id in UpRaise	1099, 29, 3456, 40412, etc.
krActions	key	String	Jira issue key	AR-12, PG-1315, etc.
key	type	String	KR action type	Jira issue Jira issue (via JQL)
type	id	Numebr	KR action type id	0 for Jira issue 1 for jql
type	name	String	Name of the KR action type