OKRs API
Endpoints
GET /okrs, list OKRs with key results
GET /okrs/{okrId}, get one OKR
POST /okrs, create OKR
PATCH /okrs/{okrId}, update title/description
PATCH /okrs/{okrId}/progress, update key result progress
Scopes
okrs:read for GET; okrs:write for POST and PATCH.
List OKRs (GET /okrs)
limit, offset, pagination
sessionId, filter by planning session / quarter UUID
curl "https://api.elevale.app/v1/workspaces/{workspaceId}/okrs?limit=10&sessionId={sessionUuid}" \
-H "Authorization: Bearer elv_pat_..."Get OKR (GET /okrs/{okrId})
Returns the OKR with its key results included.
Create body (POST)
sessionId (required), planning session UUID
objective, { title, description? }
keyResults, array of { title, target, unit?, type?, connectedKpiId? }
curl -X POST "https://api.elevale.app/v1/workspaces/{workspaceId}/okrs" \
-H "Authorization: Bearer elv_pat_..." \
-H "Content-Type: application/json" \
-d '{"sessionId":"...","objective":{"title":"Grow enterprise revenue"},"keyResults":[{"title":"Close 5 deals","target":5,"unit":"deals"}]}'Progress update (PATCH .../progress)
keyResultId (required)
currentValue (required)
notes (optional)
Related
Personal access tokens (PATs) · Scopes and permissions