API update methods

This page is about OKR for Jira Cloud. Using Data Center? Click here.

Base URL for all API calls

Prerequisites

  • All update methods are carried out using the POST HTTP method, and necessitate a JSON object with specified properties in the request body.

  • Authentication is executed in the same manner as for query methods, by utilizing the API-Token: {token} header along with your authentication token.

  • Additionally, the Content-Type: application/json header is mandatory to ensure that the server correctly interprets your request.

1. Update objective

Create updates for specified objectives.

POST /api/v2/api-update/objectives

Property

Description

Mandatory

Property

Description

Mandatory

objectiveId

ID of objective to update.

status

New state of the objective. Allowed statuses:
NOT STARTED, ON TRACK, AT RISK, OFF TRACK

description

A description to appear on created update.

Example request

POST https://okr-jira-prod.appfire.com/api/v2/api-update/objectives

Request body

{ "objectiveId": "62334eac00ee2b102e34fdb7", "status" : "ON TRACK", "description" : "Spaceship assembly docks are delivering on time" }
curl -X POST https://okr-jira-prod.appfire.com/api/v2/api-update/objectives \ -H 'Content-Type: application/json' \ -H 'API-Token: {token}' \ -d '{"objectiveId":"62334eac00ee2b102e34fdb7", "status":"ON TRACK", "description":"Spaceship assembly docks are delivering on time"}'
{ "entityId": "62334eac00ee2b102e34fdb7", "status": "ON TRACK", "created": "2022-05-20T09:58:09+0000", "value": null, "description": "Spaceship assembly docks are delivering on time" }

2. Update key result

Create updates for the specified key results.

POST /api/v2/api-update/keyResults

Property

Description

Mandatory

Property

Description

Mandatory

keyResultId

ID of key result to update.

status

New state of the key result. Allowed statuses:
NOT STARTED, ON TRACK, AT RISK, OFF TRACK

newValue

Progress value to set in update.
Can not be set for auto key results, as their value comes from JQL query.

In case KR progress unit is currency, value should still be a number, without currency symbol.

description

A description to appear on created update.

Example request:

POST https://okr-jira-prod.appfire.com/api/v2/api-update/keyResults

Request body: