---
updatedAt: 2025-12-21T10:29:01.000Z
---
Fetch the complete documentation index at: https://apidocs.hibob.com/llms.txt. Use this file to discover all available pages before exploring further.
# Update Goal
Update an existing goal details. Supports partial updates where only the fields that are provided in the request body will be updated.
**Cycle Management**: You can assign a goal to a cycle, move it between cycles, or unassign it from a cycle using the `cycleId` field:
- To assign to a cycle: provide a valid cycle ID
- To move between cycles: provide a different cycle ID
- To unassign from a cycle: provide `null` as the value
- To keep the current cycle: omit the field entirely
**Note**: Goal status updates are not supported via this endpoint. Use the Update Goal Status endpoint instead.
# OpenAPI definition
```json
{
"openapi": "3.1.1",
"info": {
"title": "Goals API",
"description": "Public API for managing Goal Types, Goals, and Key Results with clean entity separation.",
"license": {
"name": "Proprietary",
"url": "https://apidocs.hibob.com/docs/api-terms-of-use"
},
"contact": {
"name": "Hi Bob, Inc."
},
"version": "1.0.0"
},
"servers": [
{
"url": "https://api.hibob.com/v1",
"description": "Production"
},
{
"url": "https://api.sandbox.hibob.com/v1",
"description": "Sandbox"
}
],
"x-readme": {
"metrics-enabled": false
},
"tags": [
{
"name": "Goals",
"description": "Operations for managing Goal Types, Goals, and Key Results"
}
],
"paths": {
"/goals/goals/{goalId}": {
"patch": {
"operationId": "patch_goals-goals-goalid",
"tags": [
"Goals"
],
"summary": "Update Goal",
"description": "Update an existing goal details. Supports partial updates where only the fields that are provided in the request body will be updated.
**Cycle Management**: You can assign a goal to a cycle, move it between cycles, or unassign it from a cycle using the `cycleId` field:\n - To assign to a cycle: provide a valid cycle ID\n - To move between cycles: provide a different cycle ID\n - To unassign from a cycle: provide `null` as the value\n - To keep the current cycle: omit the field entirely\n\n
**Note**: Goal status updates are not supported via this endpoint. Use the Update Goal Status endpoint instead.\n",
"parameters": [
{
"name": "goalId",
"in": "path",
"required": true,
"schema": {
"type": "integer",
"format": "int64"
},
"description": "The unique identifier of the goal to update"
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UpdateGoalRequest"
},
"example": {
"items": [
{
"objectType": "goal",
"fields": {
"title": {
"value": "Updated Goal Title"
},
"description": {
"value": "Updated description"
},
"dueDate": {
"value": "2025-12-31"
},
"cycleId": {
"value": 456
}
}
}
]
}
}
}
},
"responses": {
"200": {
"description": "Goal updated successfully",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"success": {
"type": "boolean",
"example": true
},
"goalId": {
"type": "integer",
"format": "int64",
"example": 123
}
}
}
}
}
},
"400": {
"description": "Bad request with structured error response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
},
"404": {
"description": "Goal not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
},
"429": {
"description": "Rate limit exceeded",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
},
"500": {
"description": "Internal server error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
}
},
"security": [
{
"Basic": []
},
{
"Bearer": []
}
]
}
}
},
"components": {
"schemas": {
"ApiErrorResponse": {
"type": "object",
"required": [
"error",
"message",
"statusCode",
"timestamp"
],
"properties": {
"error": {
"type": "string",
"description": "Error type identifier",
"enum": [
"BAD_REQUEST",
"NOT_FOUND",
"INTERNAL_SERVER_ERROR",
"TOO_MANY_REQUESTS",
"UNAUTHORIZED",
"FORBIDDEN"
],
"example": "BAD_REQUEST"
},
"message": {
"type": "string",
"description": "Human-readable error message",
"example": "Invalid input provided"
},
"statusCode": {
"type": "integer",
"description": "HTTP status code",
"enum": [
400,
401,
403,
404,
429,
500
],
"example": 400
},
"timestamp": {
"type": "string",
"format": "date-time",
"description": "ISO timestamp when the error occurred",
"example": "2025-01-01T12:00:00Z"
}
}
},
"UpdateGoalRequest": {
"type": "object",
"description": "Request schema for updating an existing goal (all fields are optional for partial updates)",
"properties": {
"items": {
"type": "array",
"description": "Single goal update item",
"items": {
"type": "object",
"properties": {
"objectType": {
"type": "string",
"description": "Type of the object",
"enum": [
"goal"
],
"default": "goal"
},
"fields": {
"type": "object",
"properties": {
"title": {
"type": "object",
"description": "The title of the goal",
"properties": {
"value": {
"type": "string"
}
}
},
"description": {
"type": "object",
"description": "A brief description of the goal",
"properties": {
"value": {
"type": "string"
}
}
},
"startDate": {
"type": "object",
"description": "The start date of the goal",
"properties": {
"value": {
"type": "string",
"format": "date"
}
}
},
"dueDate": {
"type": "object",
"description": "The due date of the goal",
"properties": {
"value": {
"type": "string",
"format": "date"
}
}
},
"typeId": {
"type": "object",
"description": "The type ID of the goal",
"properties": {
"value": {
"type": "integer",
"format": "int64"
}
}
},
"typeListItem": {
"type": "object",
"description": "The type list item of the goal",
"properties": {
"value": {
"type": "string"
}
}
},
"owner": {
"type": "object",
"description": "The owner of the goal. Must be an existing owner identifier\n",
"properties": {
"value": {
"type": "string"
}
}
},
"isPrivate": {
"type": "object",
"description": "Whether the goal is private",
"properties": {
"value": {
"type": "boolean"
}
}
},
"alignedGoal": {
"type": "object",
"description": "The ID of the goal this goal is aligned to (if any)",
"properties": {
"value": {
"type": "integer",
"format": "int64"
}
}
},
"cycleId": {
"type": "object",
"description": "The ID of the cycle to assign this goal to. Provide a valid cycle ID to assign/move the goal to a cycle. Provide null to unassign from a cycle. Omit the field to keep the current cycle assignment unchanged.\n",
"properties": {
"value": {
"type": [
"integer",
"null"
],
"format": "int64"
}
}
}
}
}
},
"required": [
"objectType",
"fields"
]
}
}
},
"required": [
"items"
]
}
},
"securitySchemes": {
"Basic": {
"type": "http",
"scheme": "basic"
},
"Bearer": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "OAuth 2.0",
"description": "OAuth 2.0 authentication using an Access Token is available for registered partners only. Try It! does not support the full HiBob OAuth flow. You can follow these steps to complete the OAuth 2.0 flow in Postman and then paste the token here."
}
}
}
}
```