Strategic Themes & OKRs API¶
Retrieve the full portfolio OKR hierarchy from Kendis: Portfolio Themes → Strategic Themes → Objective Groups → Objectives → Key Results, with completion roll-ups, progress, metrics, and type-aware custom fields.
- Method: Versioned subdomain —
https://{yourcompany}.kendis.io/api/v1/…(details) - Auth: HTTP Basic —
email:API key - Envelope:
{ "startAt", "pageLimit", "total", "Data": [ … ] }— note the capitalData - Pagination:
startAt/pageLimitquery params (max 50) - Lookup:
{keyOrId}accepts either the item's key or its internal ID
Envelope key is Data (capital D)
This API returns its result array under Data, unlike the other Kendis APIs which use lowercase
data. Read the key exactly as documented. See Conventions.
The hierarchy¶
graph TD
PT[Portfolio Theme] --> ST[Strategic Theme]
ST --> OG[Objective Group · level 1]
OG --> O[Objective · level 2]
O --> KR[Key Result · level 3]
Each entity carries a numeric level (1 group, 2 objective, 3 key result) and a type string
("Objective Group", "Objective", "Key Result") so a flat-table consumer such as PowerBI can group rows
without tracking which endpoint produced them.
Quick reference¶
| Action | Method | Path |
|---|---|---|
| List Portfolio Themes | GET |
/api/v1/portfolio-themes |
| Get Portfolio Theme | GET |
/api/v1/portfolio-themes/{keyOrId} |
| Strategic Themes in Portfolio Theme | GET |
/api/v1/portfolio-themes/{keyOrId}/strategic-themes |
| List Strategic Themes | GET |
/api/v1/strategic-themes |
| Get Strategic Theme | GET |
/api/v1/strategic-themes/{keyOrId} |
| Objective Groups in Strategic Theme | GET |
/api/v1/strategic-themes/{keyOrId}/objective-groups |
| Strategic Theme progress | GET |
/api/v1/strategic-themes/{keyOrId}/progress |
| Objectives in Objective Group | GET |
/api/v1/objective-groups/{groupId}/objectives |
| Get Objective | GET |
/api/v1/objectives/{keyOrId} |
| Key Results for Objective | GET |
/api/v1/objectives/{keyOrId}/key-results |
| Get Key Result | GET |
/api/v1/key-results/{keyOrId} |
All URLs: https://{yourcompany}.kendis.io + the path above. All {keyOrId} parameters accept either the
item's key (e.g. CV-20, OBJ-329, KR-141) or its internal ID.