getObjectiveDetails

Background

This REST API meant to provide access to objective 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/objective/{ObjectiveId}
Below are the sample endpoints for this API based on which UpRaise app you are using

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

Request parameters

Objective id is needed as input in the endpoint URL.

On this page
1 Background 2 API Details 3 Request parameters 4 Sample responses JSON Response 5 Response parameters details

Sample responses JSON Response

{
  "id": 43513,
  "key": "OBJ-2056",
  "title": "Reduce number of leaked bugs in production",
  "description": "",
  "objectiveCycle": {
    "id": 590,
    "name": "January to March 2023"
  },
  "level": {
    "id": 0,
    "name": "Individual"
  },
  "owner": {
    "upRaiseInfo": {
      "id": 5857,
      "ownerDesignation": {
        "id": 91,
        "name": "Associate Consultant -a"
      },
      "ownerTeams": [
        {
          "id": 305,
          "name": "sales"
        },
        {
          "id": 976,
          "name": "Operations"
        },
        {
          "id": 1330,
          "name": "Sales-001"
        },
        {
          "id": 1331,
          "name": "Sales-002"
        },
        {
          "id": 937,
          "name": "team name "
        },
        {
          "id": 1297,
          "name": "30/10-01"
        },
        {
          "id": 311,
          "name": "team10"
        },
        {
          "id": 370,
          "name": "Business Development "
        },
        {
          "id": 958,
          "name": "New business - 1"
        },
        {
          "id": 1271,
          "name": "Quality Analysis"
        },
        {
          "id": 1294,
          "name": "test shweta"
        }
      ]
    },
    "jiraUserRestApiUrl": "<baseURL>/rest/api/2/user?accountId=5fb4a9df0dd553006f342981"
  },
  "startDate": "01/01/23",
  "dueDate": "31/03/23",
  "unit": {
    "id": 304,
    "name": "GR-01"
  },
  "status": {
    "id": 10,
    "name": "READY FOR GRADING"
  },
  "progress": {
    "percent": 0,
    "confidenceStatus": {
      "id": 550,
      "name": "NOT APPLICABLE"
    }
  },
  "visibility": {
    "type": "All users"
  },
  "creator": {
    "id": 5857,
    "jiraUserRestApiUrl": "<baseURL>/rest/api/2/user?accountId=5fb4a9df0dd553006f342981"
  },
  "created": "22/03/24 10:27 AM",
  "modifiedBy": {
    "id": 5857,
    "jiraUserRestApiUrl": "<baseURL>/rest/api/2/user?accountId=5fb4a9df0dd553006f342981"
  },
  "modified": "22/03/24 10:29 AM",
  "keyResults": [
    {
      "id": 29365,
      "key": "KR-4761",
      "type": {
        "id": 0,
        "name": "Metric"
      },
      "title": "reduce upraise bugs ",
      "description": "",
      "keyResultOwner": {
        "upRaiseInfo": {
          "id": 5857,
          "ownerDesignation": {
            "id": 91,
            "name": "Associate Consultant -a"
          },
          "ownerTeams": [
            {
              "id": 305,
              "name": "sales"
            },
            {
              "id": 976,
              "name": "Operations"
            },
            {
              "id": 1330,
              "name": "Sales-001"
            },
            {
              "id": 1331,
              "name": "Sales-002"
            },
            {
              "id": 937,
              "name": "team name "
            },
            {
              "id": 1297,
              "name": "30/10-01"
            },
            {
              "id": 311,
              "name": "team10"
            },
            {
              "id": 370,
              "name": "Business Development "
            },
            {
              "id": 958,
              "name": "New business - 1"
            },
            {
              "id": 1271,
              "name": "Quality Analysis"
            },
            {
              "id": 1294,
              "name": "test shweta"
            }
          ]
        },
        "jiraUserRestApiUrl": "<baseURL>/rest/api/2/user?accountId=5fb4a9df0dd553006f342981"
      },
      "startDate": "01/01/23",
      "dueDate": "31/03/23",
      "weightage": 40,
      "behavior": {
        "id": 1,
        "name": "Increase/Decrease"
      },
      "originalValue": 10,
      "targetValue": 0,
      "currentValue": 10,
      "progress": {
        "percent": 0,
        "confidenceStatus": {
          "id": 550,
          "name": "NOT APPLICABLE"
        }
      },
      "orderIndex": 0,
      "lastPunchedIn": "",
      "created": "22/03/24 10:29 AM",
      "modified": "22/03/24 10:29 AM",
      "isAbandoned": false,
      "isArchived": false
    }
  ],
  "attachments": [
    {
      "id": 6108,
      "created": "22/03/24 10:29 AM",
      "fileName": "response.txt",
      "mimeType": "text/plain",
      "size": 2366,
      "createdBy": {
        "upRaiseInfo": {
          "id": 5857,
          "ownerDesignation": {
            "id": 91,
            "name": "Associate Consultant -a"
          }
        },
        "jiraUserRestApiUrl": "<baseURL>/rest/api/2/user?accountId=5fb4a9df0dd553006f342981"
      },
      "attachmentFileApiUrl": "<baseURL>/rest/upraise/public/1.0/okr/attachment/6108"
    }
  ],
  "alignments": {
    "contributesTo": [
      {
        "id": 6670,
        "created": "22/03/24 10:29 AM",
        "sourceObject": {
          "id": 38313,
          "key": "OBJ-810",
          "objectiveApiUrl": "<baseURL>/rest/upraise/public/1.0/okr/objective/38313"
        },
        "weightage": 60
      }
    ]
  },
  "lastPunchedIn": "",
  "dateTimeFormat": "dd/MM/yy hh:mm a",
  "dateFormat": "dd/MM/yy",
  "customFields": [
    {
      "id": 2,
      "name": "Budget allocation status",
      "type": "Text field (multiple line)",
      "textValue": ""
    },
    {
      "id": 4,
      "name": "Budget allocation",
      "type": "Numeric field",
      "numberValue": ""
    },
    {
      "id": 301,
      "name": "Sample custom field",
      "type": "User picker (multiple select)",
      "userValues": []
    },
    {
      "id": 23,
      "name": "Department head",
      "type": "Text field (single line)",
      "textValue": ""
    }
  ],
  "isArchived": false,
  "watchers": [
    {
      "upRaiseInfo": {
        "id": 5857,
        "ownerDesignation": {
          "id": 91,
          "name": "Associate Consultant -a"
        }
      },
      "jiraUserRestApiUrl": "<baseURL>/rest/api/2/user?accountId=5fb4a9df0dd553006f342981"
    }
  ]
}

Response parameters details

Parent	Parameter	Type	Description	Possible values

Parent	Parameter	Type	Description	Possible values
Parameters related to objective
	id	Number	Objective id in UpRaise	1151, 26272, etc.
	key	String	UpRaise objective key	obj-12, Obj-126, etc.
	title	String	Objective title	Automate test execution to gain higher coverage of test cases Increase engagement with new customers
	description	String	Objective description	This objectives aims to reduce manual efforts
	objectiveCycle	Object	This contains all details of objective cycle details	id name
objectiveCycle	id	Number	Objective cycle id in UpRaise	2024, 2272, etc.
objectiveCycle	name	String	Objective cycle name	January to March 2024 April to June 2024
	level	Object	This object contains details of objective level	id name
level	id	Number	Id of the objective level	1, 2, 3, 4
level	name		Name of the objective level	Company Team Individual Any other custom level or level based on team type
	team	Object	This object containt all details of the team that owns the current objective. This is applicable when objective level is Team level/ level based on Team type	id name
team	id	Number	Team id of the team that owns the current objective.	917, 7901, etc.
team	name	String	Team name of the team that owns the current objective.	Sales, Operations, Support, HR, etc.
	owner	Object	This object contains details of the objective owner	upRaiseInfo id ownerTeams id name jiraUserRestApiUrl
owner	upRaiseInfo	String	This paramenter contains user’s information	id ownerTeams id name jiraUserRestApiUrl
upRaiseInfo	id	number	Objective owner’s user id	8916, 18181, etc.
upRaiseInfo	ownerTeams	String	This parameter contains all details of the objective owner’s team/s	id name jiraUserRestApiUrl
ownerTeams	id	Number	Id of the that team owner belongs to	110, 1919, etc.
ownerTeams	name	String	Name of the that team owner belongs to	Sales, Support, etc.
owner	jiraUserRestApiUrl	String	Jira user Rest API URL	<bestURL>/rest/api/2/user?accountId=6327fe4c61dbef2805bb9a62
	startDate	Date	Objective start date	21/March/2024
	dueDate	Date	Objective end date	31/March/2024
	status	Object	This object contains all objective status details	id name
status	id	Number	Id of the objective status	1, 2, 3, 4, etc.
status	name	String	Name of the objective status	Scheduled Ready In progress Ready for grading Ready to close Closed Abandoned
	progress	Object	This object contains all details of the objective progress
progress	percent	Number	Progress % of the objective
percent	confidenceStatus	String	Confirdenec status of objective
confidenceStatus	id	Number	Id of the confidence status
confidenceStatus	name	string	Name of the confidence status
progress	confidenceScore	Number	Confidence score of the objective
	visibility	Object	This object contains details of the visibility settings of the objective	type
visibility	type	String	The type of the visibility of the objective	All users All users in the unit Selected teams or users
	labels	Object	This object contains details of the associated labels with the objective	id name
labels	id	Number	Id of the label	1, 20, 40, etc.
labels	name	String	Name of the label	Strategy, New projects, Employee welfare, Adaptability, etc.
	creator	Object	This object contains details of the objective creator	id jiraUserRestApiUrl
creator	id	Number	Id of the user who created objective	1234, 5672, etc.
creator	jiraUserRestApiUrl	String	Jira users API URL	<baseURL>/rest/api/2/user?accountId=6327fe4c61dbef2805bb9a62
	created	date	Date when objective was created	21/Mar/24 05:14
	modifiedBy	Object	This object contains the details of user who modified the objective	id jiraUserRestApiUrl
modifiedBy	id	Number	User id who modified objective	1, 2, 7373, 3737, etc.
modifiedBy	jiraUserRestApiUrl	String	Jira user API URL for user who modified the objective	<baseUrl>t/rest/api/2/user?accountId=6327fe4c61dbef2805bb9a62
	modified	Date	The date when objective was modified	21/Mar/24 05:24
	attachments	Object	This object contains parameters related attchments within the objective	id, created, filename, mimetype, size, createdBy, attachmentFileApiUrl
	id	Number	Id of the attachment	891, 2525, etc.
	created	Date	Date when attachment is created	21/Mar/24 05:24
	filename	String	File name of the attchement	image (20).png, etc.
	mimetype	String	Type of the attched image	image/png, PDF, etc.
	size	Number	Size of the attached file	Size of the attached file
	createdBy	String	Contains details of the user who created the attachment	upRaiseInfo