Documentation

Key Results

Create key result

Create a new key result for an objective. Can have quantitative targets or be binary (no target).

ProductionStagingUAT
POSThttps://ankiren.com/api/me/okr/objectives/{id}/key-results

Parameters

Path Parameters

  • idintegerpathRequired

    Objective ID

Request Body

Bắt buộc.

  • titlestringRequired

    Key result title

  • targetValuenumber

    Target value for quantitative KRs

  • currentValuenumber

    Current progress value

    default: 0
  • unitstring

    Unit of measurement

  • sortOrderinteger
application/json
{
  "title": "Run 100 kilometers",
  "targetValue": 100,
  "currentValue": 0,
  "unit": "km",
  "sortOrder": 0
}

Responses

201 · Key result created

  • keyResultOkrKeyResult
    • idinteger
    • objectiveIdinteger
    • userIdstring
    • titlestring
    • targetValuenumber?

      Target value for quantitative KRs

    • currentValuenumber

      Current progress value

    • unitstring?

      Unit of measurement

    • sortOrderinteger
    • status"active" | "completed" | "cancelled"

      Status of the OKR item

    • createdAtstring<date-time>
      format: date-time
    • updatedAtstring<date-time>
      format: date-time
application/json
{
  "keyResult": {
    "id": 0,
    "objectiveId": 0,
    "userId": "string",
    "title": "string",
    "targetValue": 0,
    "currentValue": 0,
    "unit": "string",
    "sortOrder": 0,
    "status": "active",
    "createdAt": "2026-01-01T00:00:00.000Z",
    "updatedAt": "2026-01-01T00:00:00.000Z"
  }
}

Sample Code

Đổi ngôn ngữ ở ô Language trên thanh Documentation.

cURL
curl -X POST 'https://ankiren.com/api/me/okr/objectives/{id}/key-results' \
  -H 'Authorization: Bearer <token>' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "title": "Run 100 kilometers",
  "targetValue": 100,
  "currentValue": 0,
  "unit": "km",
  "sortOrder": 0
}'