> ## Documentation Index > Fetch the complete documentation index at: https://docs.kuahr.com/llms.txt > Use this file to discover all available pages before exploring further. # Create an objective > Creates an objective with its key results. Requires `performance:write`. ## OpenAPI ````yaml https://api.kuahr.com/openapi/v1.json post /v1/performance/objectives openapi: 3.1.1 info: title: Kua API description: >- The Kua developer API — payroll, wallets, and payments for your own company. Authenticate with an API key issued from **Settings → API keys** in the dashboard, sent in the `X-Api-Key` header. Every request is scoped to the company that owns the key. Base URL: `https://api.kuahr.com` (all endpoints are versioned under `/v1`). version: v1 servers: - url: https://api.kuahr.com description: Production security: - ApiKey: [] tags: - name: Payroll description: List and create payroll runs. - name: Employees description: Add people to your company. - name: Events description: The company event timeline (also delivered via webhooks). - name: Webhooks description: Register endpoints and inspect deliveries. - name: Test data description: Manage sandbox (test-mode) data. - name: Leave description: >- Time-off types, requests, balances, and allocations (requires the Leave add-on). - name: Advances description: Salary advances (requires the Salary advance add-on). - name: Performance description: OKRs, appraisals, and promotions (requires the Performance add-on). paths: /v1/performance/objectives: post: tags: - Performance summary: Create an objective description: Creates an objective with its key results. Requires `performance:write`. requestBody: content: application/json: schema: $ref: '#/components/schemas/V1CreateObjectiveRequest' example: title: Grow monthly active users description: Focus on activation cycleLabel: 2026 Q3 cycleStart: '2026-07-01' cycleEnd: '2026-09-30' keyResults: - description: Reach 50k MAU targetValue: 50000 unit: users required: true responses: '201': description: Created content: application/json: schema: $ref: '#/components/schemas/ObjectiveDetailDto' example: objective: id: 7a8b9c0d-0000-0000-0000-000000000001 ownerEmployeeId: b2c3d4e5-0000-0000-0000-000000000001 title: Grow monthly active users description: Focus on activation cycleLabel: 2026 Q3 cycleStart: '2026-07-01' cycleEnd: '2026-09-30' status: Active createdAt: '2026-07-01T09:00:00+00:00' updatedAt: '2026-07-01T09:00:00+00:00' keyResults: - id: 8b9c0d1e-0000-0000-0000-000000000001 objectiveId: 7a8b9c0d-0000-0000-0000-000000000001 description: Reach 50k MAU targetValue: 50000 currentValue: 0 unit: users confidenceScore: 0.5 checkIns: [] '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ApiError' '401': description: Unauthorized '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ApiError' components: schemas: V1CreateObjectiveRequest: required: - ownerEmployeeId - title - description - cycleLabel - cycleStart - cycleEnd - keyResults type: object properties: ownerEmployeeId: type: string format: uuid title: type: string description: type: - 'null' - string cycleLabel: type: string cycleStart: type: string format: date cycleEnd: type: string format: date keyResults: type: array items: $ref: '#/components/schemas/V1KeyResultSpec' ObjectiveDetailDto: required: - objective - keyResults - checkIns type: object properties: objective: $ref: '#/components/schemas/ObjectiveDto' keyResults: type: array items: $ref: '#/components/schemas/KeyResultDto' checkIns: type: array items: $ref: '#/components/schemas/CheckInDto' description: An objective with its key results and recent check-ins. ApiError: required: - code - message type: object properties: code: type: string description: >- A stable, machine-readable identifier you can branch on, e.g. `INSUFFICIENT_SCOPE`. message: type: string description: A human-readable explanation. May change; don't parse it. description: The standard error body returned for 4xx responses. V1KeyResultSpec: required: - description - targetValue - unit type: object properties: description: type: string targetValue: pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$ type: - number - string format: double unit: type: string ObjectiveDto: required: - id - ownerEmployeeId - title - description - cycleLabel - cycleStart - cycleEnd - status - createdAt - updatedAt type: object properties: id: type: string format: uuid ownerEmployeeId: type: string format: uuid title: type: string description: type: - 'null' - string cycleLabel: type: string description: The cycle this objective belongs to, e.g. `2026 Q3`. cycleStart: type: string format: date cycleEnd: type: string format: date status: type: string description: One of `Active`, `Completed`, `Abandoned`. createdAt: type: string format: date-time updatedAt: type: string format: date-time description: An objective (OKR). KeyResultDto: required: - id - objectiveId - description - targetValue - currentValue - unit - confidenceScore type: object properties: id: type: string format: uuid objectiveId: type: string format: uuid description: type: string targetValue: pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$ type: - number - string format: double currentValue: pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$ type: - number - string format: double unit: type: string confidenceScore: pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$ type: - number - string description: Owner's confidence, 0.0–1.0. format: double description: A key result under an objective. CheckInDto: required: - id - objectiveId - authorEmployeeId - note - confidence - createdAt type: object properties: id: type: string format: uuid objectiveId: type: string format: uuid authorEmployeeId: type: string format: uuid note: type: string confidence: pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$ type: - number - string format: double createdAt: type: string format: date-time description: A progress note on an objective. securitySchemes: ApiKey: type: apiKey description: Your API key, e.g. `kua_live_…` (or `kua_test_…` in test mode). name: X-Api-Key in: header ````