Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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  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

title
Info
iconfalse

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

  • id

  • name

type

id

Number

Key result type id in UpRaise 

  • 3

  • 4

type

name

String

Key result type name in UpRaise (Only Jira issue & Jira issue (via JQL) type KR in UpRaise)

  • Jira issue

  • Jira issue (via JQL)

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 of

about current progress of the current key result.

  • percent

progress

percent

Number

This returns the current progress 

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 t

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.

  • 1

  • 2

  • 3

  • etc

keyResult

jql

String

This parameter is applicable only in case of Jira issue via JQL. 

  • project = UPW AND issuetype = bug AND assignee = JohnB

  • Project = UPW AND sprint = 3 AND status = done

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

about grades of the current key result.


grades

gradesBy

Object

This object consists of details

about the

about the user who has provided grades

on current key

on current key result.


grades

grade

Number

Grades given on key result

  • 5, 5.5, 7.5, etc (OR)

  • Achieved, Not Achieved, etc


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

  • Overall progress percentage of the this key result is average. We expected more progress on this. 

  • Good job on this key result, keep it up!


On this page

Table of Contents

In this section

Child pages (Children Display)
pageREST APIs for Objectives & Key Results