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
200
OK
application/json
400
Bad Request – invalid request payload.
401
Unauthorized – missing or invalid JWT.
403
Forbidden – insufficient permissions.
404
Not Found – no Entity with that ID.
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
201
Created
application/json
400
Bad Request – invalid request payload.
401
Unauthorized – missing or invalid JWT.
403
Forbidden – insufficient permissions.
404
Not Found – no Entity with that ID.
post
/api/v1/objective
Get objective
get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idstringRequired
Responses
200
OK
application/json
400
Bad Request – invalid request payload.
401
Unauthorized – missing or invalid JWT.
403
Forbidden – insufficient permissions.
404
Not Found – no Entity with that ID.
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
200
OK
application/json
400
Bad Request – invalid request payload.
401
Unauthorized – missing or invalid JWT.
403
Forbidden – insufficient permissions.
404
Not Found – no Entity with that ID.
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
200
OK
application/json
400
Bad Request – invalid request payload.
401
Unauthorized – missing or invalid JWT.
403
Forbidden – insufficient permissions.
404
Not Found – no Entity with that ID.
post
/api/v1/objective/{id}/progress
List objective cycles
get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
statusstringOptional
Responses
200
OK
application/json
400
Bad Request – invalid request payload.
401
Unauthorized – missing or invalid JWT.
403
Forbidden – insufficient permissions.
404
Not Found – no Entity with that ID.
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
201
Created
application/json
400
Bad Request – invalid request payload.
401
Unauthorized – missing or invalid JWT.
403
Forbidden – insufficient permissions.
404
Not Found – no Entity with that ID.
post
/api/v1/objective-cycle
Get objective cycle
get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idstringRequired
Responses
200
OK
application/json
400
Bad Request – invalid request payload.
401
Unauthorized – missing or invalid JWT.
403
Forbidden – insufficient permissions.
404
Not Found – no Entity with that ID.
get
/api/v1/objective-cycle/{id}
Update objective cycle
patch
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.