Set the running timer's note
Set the running timer's note. Any role; caller's own timer only. Overwrites the whole note. Plan: Studio or Agency (API access). Scope: write.
Authorization
BearerAuth Personal Access Token. Mint at Settings → API. Token shape: hsk_<env>_<prefix12>_<secret32>.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/time-entries/timer/note" \ -H "Content-Type: application/json" \ -d '{ "expectedTimerId": "4530385e-85a3-47a1-83ad-46e09b5e6c36", "note": "string" }'{ "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "orgId": "25b2c2d5-a7fc-47d0-89e4-8709a1560bfa", "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b", "projectId": "5a8591dd-4039-49df-9202-96385ba3eff8", "taskId": "e6e9d88a-9b63-468a-aec3-b7a11de27af8", "invoiceId": "4f163819-178d-470c-a246-d6768476a6ec", "durationSeconds": 0, "billable": true, "note": "string", "entryDate": "2019-08-24", "startedAt": "2019-08-24T14:15:22Z", "stoppedAt": "2019-08-24T14:15:22Z", "isRunning": true, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "deletedAt": "2019-08-24T14:15:22Z" }, "warnings": [ "string" ]}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}Discard the caller's running timer
Any role; caller's own timer only. PERMANENT hard delete: no time is recorded and nothing can be restored. Plan: Studio or Agency (API access). Scope: write.
Time summary
Totals and grouped subtotals of tracked time. groupBy day|week|month|client|project|task|member (weeks start Monday); groups are paged. Omit from and to for the previous calendar month in the caller's timezone; from alone runs through today; to without from is a 422. Billable = billable time on HOURLY projects. Owner/Admin/Manager responses include estimatedBillable per client currency (each entry rounded up to 15 minutes at the project's current rate). Members see only their own time, only on projects they currently belong to, and never money, and a userId other than their own is a 404. Any role. Plan: Studio or Agency (reports); otherwise 402. Read-only; requires a token with read scope. Unknown or repeated (non-list) query parameters, impossible dates and inverted ranges return 422 with `fields`. Money is an exact decimal string paired with its currency; amounts in different currencies are never added together and nothing is converted. Responses are private (Cache-Control: private, no-store; Vary: Authorization).