RyTask docs
REST APITimers

Start a timer on a work item

Starts the caller's timer on this item. If another timer is already running for the caller, it is stopped first (its elapsed time becomes a time log) — there is never more than one active timer per person. Requires `work:write`.

View as MarkdownOpen in ChatGPTOpen in Claude
POST
/work-items/{workItemId}/timer/start

Starts the caller's timer on this item. If another timer is already running for the caller, it is stopped first (its elapsed time becomes a time log) — there is never more than one active timer per person. Requires work:write.

Authorization

bearerAuth
AuthorizationBearer <token>

A session access token or a personal access token.

In: header

Path Parameters

workItemId*string

Header Parameters

Idempotency-Key?string

Retrying with the same key replays the original result instead of repeating the work.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/work-items/497f6eca-6276-4993-bfeb-53cbbbba6f08/timer/start" \  -H "Content-Type: application/json" \  -d '{}'
{  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "workItemId": "1769c5a2-ca6e-4792-8bf1-b1a261dc7481",    "startedAt": "2019-08-24T14:15:22Z",    "note": "string"  }}
Empty
Empty
Empty
Empty