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
POST
https://app.softsolz.uk/api/v1/services/tasks/time/startRecent Requests
Kept only in this browserTimeStatusTook
Send a request with Try it to see it here.
Headers
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Body Params
task_idintegerrequiredThe task.
assignment_idinteger | nullThe work on that task.
notestringA 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 } }}