Read the caller's currently running time entry
Returns the caller's active or paused timer from whichever workspace it belongs to, or null when nothing is running, along with the server time and authoritative elapsed milliseconds so a drifting client clock can be corrected. Account-scoped: any authenticated caller may read their own entry, and it is only returned while they still hold `time_entries:read` in that workspace.
Authorization
apiKey Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
In: header
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/me/time-entry"{ "data": { "entry": { "id": "string", "workspaceId": "string", "userId": "string", "userDisplayName": "string", "targetKind": "database_record", "targetId": "string", "targetTitleSnapshot": "string", "databaseId": "string", "fieldId": "string", "fieldLabelSnapshot": "string", "source": "timer", "mode": "stopwatch", "status": "active", "startedAt": "string", "endedAt": "string", "pausedAt": "string", "accumulatedPausedMs": 0, "durationMs": 0, "targetDurationMs": 0, "dueAt": "string", "summary": "string", "soundId": "none", "completedBy": "user", "shiftId": "string", "clientMutationId": "string", "createdByUserId": "string", "updatedByUserId": "string", "createdAt": "string", "updatedAt": "string" }, "serverTime": "string", "authoritativeElapsedMs": 0 }}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}Unfurl an external URL into a link preview
Fetches the page named by the `url` query parameter server-side and returns its title, description, preview image, site name, and icon, parsed from Open Graph, Twitter card, and plain HTML tags. Requires the `workspace:read` permission. Only public http(s) URLs are resolved: other schemes, `localhost`, and private or loopback IP addresses are refused as validation errors, redirects are followed at most three times with each hop re-checked, the response body is read up to 512 KB, and non-HTML responses come back as a bare URL. Results are cached for a day per URL, and a missing `url`, an unreachable host, or a non-success response is reported as a validation or fetch error.
Start a timer on a record or the workspace
Starts a stopwatch or pomodoro entry against the given target, defaulting the mode and duration from the target field's settings, and returns the running entry with the server clock. Requires a workspace member with `time_entries:write` who can also write the target record, and the `time_tracking_v1` feature control must be enabled. A caller who already has a running timer is refused until they stop or abandon it. Repeating the same `clientMutationId` replays the original entry instead of starting a second one.