SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester
Tasks

Move work to another status. Moving to another stage runs the same step as the dashboard (start, send for review, approve, send back, block, cancel or reopen). Refusals: 403 move_not_allowed, 409 invalid_transition, 409 wip_limit_reached, 422 comment_required, fields_required, checklist_required, files_required or submission_needed

POSThttps://app.softsolz.uk/api/v1/services/tasks/assignments/{id}/move

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

idstringrequired

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Body Params

to_statestringrequired

Key of the status to move to.

commentstring

Comment, used as the feedback or reason where one is needed.

expected_updated_atstring

Refuse with 409 STALE_VERSION if the work changed since this time.

Response

Response Body

idintegerAssignment id.
statusstringStatus of the work.
state_keystringStatus key on the board.
updated_atstringLast change.

Request

curl --request POST \
--url https://app.softsolz.uk/api/v1/services/tasks/assignments/{id}/move \
--header 'Authorization: Bearer sk_live_your_key' \
--header 'Content-Type: application/json' \
--data '{
"to_state": "done",
"comment": "Looks good."
}'

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": 118,
"status": "in_progress",
"state_key": "in_progress",
"updated_at": "2026-01-01T09:00:00.000Z"
}
}