Bulk Score Key Results
Score many key results at once, as a team page’s score grid does.
Each new score is a check-in with no note, by the caller (a key’s
maker, for a key), and the activity feed says they were scored;
null clears a score, and any check-in or grade it has then shows
again. Needs checkIns:write.
Nothing sent is refused one by one: what is left alone comes back
in skipped, with why. A key may score any key result in its
workspace; a signed-in session those its person may update (see
createCheckIn).
Expensive: besides the caller’s own limits, it counts against
okr-bulk (see “Rate limits”).
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
This endpoint expects an object.
scores
Key result id → its new score from 0.0 to 1.0, or null to clear it; at most 500.
Response
This endpoint returns an object.
updated
How many key results changed.
objectiveIds
The objectives they belong to.
skipped
Every key result sent that was left alone, and why.
Errors
402
Subscription Required Error
403
Forbidden Error
422
Validation Error
429
Too Many Requests Error