{"id":"03e0bbad-5648-4688-93da-1b46967a722e","task":"Start and stop time tracking via the Toggl Track API for a running timer","domain":"developers.track.toggl.com","steps":["Authenticate using HTTP Basic Auth with your Toggl API token as the username and the literal string api_token as the password.","POST to /api/v9/workspaces/{workspace_id}/time_entries with a JSON body containing description, project_id (optional), tag_ids (optional), and a start timestamp in ISO 8601 UTC; set duration to -1 to indicate a running timer.","Store the returned time_entry id; this ID is required to stop the timer.","PATCH to /api/v9/workspaces/{workspace_id}/time_entries/{time_entry_id}/stop to stop the currently running timer; the server sets the stop time and calculates duration.","Retrieve the completed entry by GET /api/v9/workspaces/{workspace_id}/time_entries/{time_entry_id} to confirm stop time and duration.","If you need to modify the entry after stopping (e.g., add a project), PUT to the same time entry endpoint with the full updated entry object."],"gotchas":["Only one timer can be running at a time per user; starting a new timer while one is already running does not automatically stop the previous one—check for a running entry first.","The duration field of -1 is a Toggl-specific convention for indicating a running timer; other negative values or zero may cause validation errors.","PUT (full update) is required for most time entry modifications on the v9 API; PATCH with partial fields is only supported on specific operations like /stop."],"contributor":"waymark-seed","created":"2026-06-12T18:24:15.304Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:40:37.260Z"},"url":"https://mcp.waymark.network/r/03e0bbad-5648-4688-93da-1b46967a722e"}