OKRs (or Goals)

The OKRs API provides generic functionality for a broad set of Goal types - including OKRs, Rocks or KPIs. For simplicity, these are referenced as OKRs below. OKRs can be measurable or not and can have any number of children or parents that contribute to its current value. OKRs can be assigned to both Employees and Groups/Teams and by default are allowed to be assigned an owner and support tasks.

List objectives

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
statusstringOptional
Responses
chevron-right
200

OK

application/json
get
/api/v1/objective

Create objective

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
namestringOptional
descriptionstringOptional
startDatestring · dateOptional
endDatestring · dateOptional
cycleIdstring · uuidOptional
parentIdstring · uuidOptional
startingValuenumberOptional
currentValuenumberOptional
targetValuenumberOptional
metricTypestringOptional
metricUnitstringOptional
weightTowardsParentintegerOptional
assessmentstringOptional
visibilitystringOptional
ownerstring · uuidOptional
orderintegerOptional
Responses
post
/api/v1/objective

Get objective

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idstringRequired
Responses
chevron-right
200

OK

application/json
get
/api/v1/objective/{id}

Update objective

patch
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idstringRequired
Body
namestringOptional
descriptionstringOptional
startDatestring · dateOptional
endDatestring · dateOptional
cycleIdstring · uuidOptional
parentIdstring · uuidOptional
startingValuenumberOptional
currentValuenumberOptional
targetValuenumberOptional
metricTypestringOptional
metricUnitstringOptional
weightTowardsParentintegerOptional
assessmentstringOptional
visibilitystringOptional
ownerstring · uuidOptional
orderintegerOptional
Responses
chevron-right
200

OK

application/json
patch
/api/v1/objective/{id}

Log objective progress

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idstringRequired
Body
typestringRequired
valuenumberRequired
requestorstring · uuidOptional
Responses
chevron-right
200

OK

application/json
post
/api/v1/objective/{id}/progress

List objective cycles

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
statusstringOptional
Responses
chevron-right
200

OK

application/json
get
/api/v1/objective-cycle

Create objective cycle

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
namestringRequired
descriptionstringOptional
startDatestring · dateRequired
endDatestring · dateRequired
Responses
post
/api/v1/objective-cycle

Get objective cycle

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idstringRequired
Responses
chevron-right
200

OK

application/json
get
/api/v1/objective-cycle/{id}

Update objective cycle

patch
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idstringRequired
Body
namestringRequired
descriptionstringOptional
startDatestring · dateRequired
endDatestring · dateRequired
Responses
chevron-right
200

OK

application/json
patch
/api/v1/objective-cycle/{id}

Last updated

Was this helpful?