Reorder Key Results

POST

/objectives/:objectiveId/key-results/reorder

POST

/api/v1/objectives/:objectiveId/key-results/reorder

curl -X POST https://api.taktoria.com/api/v1/objectives/obj_7f3a/key-results/reorder \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "ids": [
    "kr_2",
    "kr_1"
  ]
}'

{
  "data": [
    {
      "id": "kr_2",
      "objectiveId": "obj_7f3a",
      "title": "90% of new workspaces invite a second person",
      "weight": 1,
      "priority": "P2",
      "draft": false,
      "sortOrder": 0,
      "ownerUserIds": [],
      "ownerTeamIds": [],
      "createdAt": "2026-07-01T12:00:00Z",
      "updatedAt": "2026-07-01T12:00:00Z"
    },
    {
      "id": "kr_1",
      "objectiveId": "obj_7f3a",
      "title": "Median time to first launch under 10 minutes",
      "weight": 1,
      "priority": "P1",
      "draft": false,
      "sortOrder": 1,
      "ownerUserIds": [],
      "ownerTeamIds": [],
      "createdAt": "2026-07-01T12:00:00Z",
      "updatedAt": "2026-07-01T12:00:00Z",
      "score": 0.6
    }
  ]
}

Put all of an objective’s key results in a new order at once: every one of its key result ids, once each, or a 422 and nothing moves. Returns them in their new order. A key may reorder any objective’s; a signed-in session one its person may edit (see updateObjective), or 403 forbidden.

Authentication

AuthorizationBearer

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

Path parameters

objectiveIdstringRequired

Request

This endpoint expects an object.

idslist of stringsRequired

Every one of the objective's key result ids, once each, in their new order.

Response

This endpoint returns an object.

datalist of objects

Errors

403

Forbidden Error

404

Not Found Error

422

Validation Error

429

Too Many Requests Error