Get KR grades (Jira issue & Jira issue via JQL)
API URL to get KR grades (Jira issue & Jira issue via JQL)
Use below endpoint to get KR grades
Syntax - <Jira base URL>/rest/amoeboids-upraise/1.0/okr/keyresult/{linked id}/getgrades-jira-jql
Example - jira.amoeboids.com/rest/amoeboids-upraise/1.0/okr/keyresult/11/getgrades-jira-jql
If the key result is deleted or its id is incorrect, relevant message is returned.
Request
Linked id is needed as input in the endpoint URL
how to get linked id?
To get linked id of Jira issue KR and Jira issue via JQL, use response id in 'linkedId' parameter in Get objective details API by. In get objective details API, use the parent objective id of respective Jira KR.
Response
Parent | Parameter | Type | Description | possible values |
---|---|---|---|---|
| dateTimeFormat | String | Format definition of dateTime fields returned in response. |
|
| dateFormat |
| Format definition of dateTime fields returned in response. |
|
| keyResult | Object | This object consists of all data points of key result |
|
keyResult | linkId | Number | Jira issue linked in in UpRaise | 1245, 56, 78, 99, etc |
keyResult | type | Object | This object consists of all data points of key result type in UpRaise |
|
type | id | Number | Key result type id in UpRaise |
|
type | name | String | Key result type name in UpRaise (Only Jira issue & Jira issue (via JQL) type KR in UpRaise) |
|
keyResult | title | String | JQL key result title or Jira issue summary in case of Jira issue key result |
|
keyResult | progress | Object | This object consists of details about current progress of the current key result. |
|
progress | percent | Number | This returns the current progress of key result | 20.0, 50.55. 7.56, etc |
progress | weightage | Number | Any non-decimal number between 0-10 as weight of the key result, in relation to its parent objective | Any non-decimal number between 0-10 |
keyResult | orderIndex | Number | Priority of the current key result as compared to other key results under its parent objective. |
|
keyResult | jql | String | This parameter is applicable only in case of Jira issue via JQL. |
|
keyResult | gradeApiUrl | String | Url endpoint to retrieve grades associated with this key result. | For example - http://upraise-jira7.amoeboids.com/rest/amoeboids-upraise/1.0/okr/keyresult/1665/getgrades-jira-jql |
keyResult | grades | Object | This object consists of details about grades of the current key result. |
|
grades | gradesBy | Object | This object consists of details about the user who has provided grades on current key result. |
|
grades | grade | Number | Grades given on key result |
|
grades | gradedOn |
| Date on which graded are added in UpRaise | 04/Jun/19 3:54 PM |
grades | comment |
| Any comment added as remark while adding grades |
|