SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester
Tasks

Start a timer on a task the member can see. A running timer is stopped first. It is recorded for the connected member, or for the member who created the key

POSThttps://app.softsolz.uk/api/v1/services/tasks/time/start

Recent Requests

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

Headers

Authorizationstringrequired

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

Body Params

task_idintegerrequired

The task.

assignment_idinteger | null

The work on that task.

notestring

A note, up to 1000 characters.

Response

Response Body

entryobjectThe timer that started.
stoppedobject | nullThe timer stopped.

Request

curl --request POST \
--url https://app.softsolz.uk/api/v1/services/tasks/time/start \
--header 'Authorization: Bearer sk_live_your_key' \
--header 'Content-Type: application/json' \
--data '{
"task_id": 40
}'

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 · 201

{
"data": {
"entry": {
"id": 90,
"task_id": 40,
"task": {
"id": 1,
"title": "your-title"
},
"assignment_id": 1,
"user": {
"id": 12,
"name": "Sam Lee"
},
"source": "timer",
"started_at": "2026-01-01T09:00:00.000Z",
"ended_at": "2026-01-01T09:00:00.000Z",
"minutes": 1,
"note": "your-note",
"billable": true,
"status": "running",
"decided_by": {
"id": 12,
"name": "Sam Lee"
},
"decided_at": "2026-01-01T09:00:00.000Z",
"decision_note": "your-decision-note",
"capped": true
},
"stopped": {
"id": 90,
"task_id": 40,
"task": {
"id": 1,
"title": "your-title"
},
"assignment_id": 1,
"user": {
"id": 12,
"name": "Sam Lee"
},
"source": "timer",
"started_at": "2026-01-01T09:00:00.000Z",
"ended_at": "2026-01-01T09:00:00.000Z",
"minutes": 1,
"note": "your-note",
"billable": true,
"status": "running",
"decided_by": {
"id": 12,
"name": "Sam Lee"
},
"decided_at": "2026-01-01T09:00:00.000Z",
"decision_note": "your-decision-note",
"capped": true
}
}
}