Versions Compared

Key

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

...

Background

This REST API is meant to punch in the Objectives and KRs.

API Details

  • This API will require valid authentication & will expect the user API token in the request.

Request

Below are the endpoints for this API based on which UpRaise app you are using -

On this page

Table of Contents
minLevel2
maxLevel6
outlinefalse
typelist
printablefalse

Iframe
scrollingauto
srchttps://form.typeform.com/to/loItQqk5#url=xxx
width350
frameborderhide
alignmiddle
height250

Request Payload for objective punch-in

Code Block
//To share with all users use 1 against "sharedWith"
{
  "progressPercent": 10,
  "comment": {
    "message": "new with objective punchin",
    "sharedWith": 1
    },
  "confidenceScore": 6
}

//To share with selected users use 3 against "sharedWith" & email id of users against with "sharedWithUsers"
{
  "progressPercent": 10,
  "comment": {
    "message": "new with objective punchin",
    "sharedWith": 3,
    "sharedWithUsers": ["emailid-1","emailid-2"]
    },
  "confidenceScore": 6
}

Request parameters

Parent

Parameter

Type

Description

Possible values

progressPercent

Number

The progress percentage of the objective

Any decimal or non-decimal number

comment

String

This object contains the parameters related to comments

  • message

message

String

Actual punch in the comment

Any punch in comment

shareWith

String

This defines whether the punch-in comment is shared with all or selected users

  • To share with all users use 1 against "sharedWith"

  • To share with selected users use 3 against "sharedWith"

sharedWithUsers

String

Add email ID of users against this parameter

john.doe@acme.com, peter.shaw@acme.com

confidenceScore

Number

Any number between 0-10 as confidence score. No decimal numbers are accepted.

Any number between 0-10 as confidence score. No decimal numbers are accepted.

Response

Code Block
"Objective is updated successfully."

Request Payload for objective punch-in

Code Block
//To share with all users use 1 against "sharedWith"
{
  "currentValue": 23,
  "comment": {
    "message": "improve performance",
    "sharedWith": 1
    },
  "confidenceScore": 4
}
//To share with selected users use 3 against "sharedWith" & email id of users against with "sharedWithUsers"
{
  "currentValue": 10,
  "comment": {
    "message": "I have completed task assigned to me on time",
    "sharedWith": 3,
    "sharedWithUsers": ["emailid-1","emailid-2"]
    },
  "confidenceScore": 6
}

Request parameters

Parent

Parameter

Type

Description

Possible values

currentValue

Number

The current progress number of the KR

Any number

comment

String

This contains the mandatory comment that needs to be added while doing progress punch-in

  • message

message

String

The actual punch-in comment

Any punch in comment

sharedwith

Number

This defines whether the punch-in comment is shared with all or selected users

  • To share with all users use 1 against "sharedWith"

  • To share with selected users use 3 against "sharedWith"

sharedWithUsers

String

Add email ID of users against this parameter to share punch-in update and comment with selected users

john.doe@acme.com, peter.shaw@acme.com

confidenceScore

Number

Any number between 0-10 as confidence score. No decimal numbers are accepted.

Any number between 0-10 as confidence score. No decimal numbers are accepted.

Response

Code Block
"Objective is updated successfully."