Skip to navigation
API ReferenceOkr

Reorder Objectives

Put objectives in the order given, as dragging them on a list does. The workspace has one order (sortOrder) and a list shows some of it, so the objectives named swap among the places they already hold, and the rest stay put. Needs objectives:write.

A key may move any. A signed-in session must see every objective named (one it may not see is a 404, as on every write) and may edit each whose place changes (see updateObjective), or 403 forbidden and nothing moves.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
idslist of stringsRequired

Objective ids in their new order, 1 to 1000. They swap among the places they already hold in the workspace’s order; the rest stay put.

Response

This endpoint returns an object.
movedinteger
How many objectives changed place.

Errors

402
Subscription Required Error
403
Forbidden Error
404
Not Found Error
422
Validation Error
429
Too Many Requests Error