Change a goal. Planners and the goal owner can do this
PATCH
https://app.softsolz.uk/api/v1/services/tasks/goals/{id}Recent Requests
Kept only in this browserTimeStatusTook
Send a request with Try it to see it here.
Path Params
idstringrequiredHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Body Params
titlestringGoal title.
descriptionstring | nullMore about the goal.
statusstringHow the goal is going.
period_startstringStart of the period.
period_endstringEnd of the period.
owner_user_idinteger | nullMember who owns it.
org_unit_idinteger | nullDepartment or location.
parent_goal_idinteger | nullGoal it rolls up to.
Response
Response Body
idintegerGoal id.titlestringGoal title.descriptionstring | nullMore about the goal.statusstringHow the goal is going.period_startstring | nullStart of the period.period_endstring | nullEnd of the period.ownerobject | nullMember who owns the goal.org_unitobject | nullDepartment or location, or null when there is none.parentobject | nullThe goal this one rolls up to.progress_percentintegerMean progress of its key results.key_resultsarray of objectsIts key results.updated_atstringLast change.Request
curl --request PATCH \ --url https://app.softsolz.uk/api/v1/services/tasks/goals/{id} \ --header 'Authorization: Bearer sk_live_your_key' \ --header 'Content-Type: application/json' \ --data '{ "title": "Grow sign-ups"}'Credentials
Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.
Response · 200
{ "data": { "id": 9, "title": "Grow sign-ups", "description": "your-description", "status": "on_track", "period_start": "2026-01-01", "period_end": "2026-01-01", "owner": { "id": 12, "name": "Sam Lee" }, "org_unit": { "id": 1, "name": "your-name" }, "parent": {}, "progress_percent": 1, "key_results": [ { "id": 31, "goal_id": 9, "title": "Weekly sign-ups", "measure": "number", "start_value": 1, "target_value": 1, "current_value": 1, "unit": "your-unit", "project": { "id": 1, "name": "your-name" }, "progress_percent": 1 } ], "updated_at": "2026-01-01T09:00:00.000Z" }}