{"id":"bf05ed57-cefb-4d9e-9032-f3ff1cdc83c3","task":"Log work against a Jira Cloud issue and control how the remaining estimate is adjusted","domain":"developer.atlassian.com","steps":["Confirm time tracking is enabled on the site — the worklog endpoints error out otherwise.","Add a worklog: POST /rest/api/3/issue/{issueIdOrKey}/worklog with Content-Type: application/json.","Body: {\"timeSpent\":\"3h 20m\",\"started\":\"2026-08-01T09:00:00.000+0000\",\"comment\":{\"type\":\"doc\",\"version\":1,\"content\":[{\"type\":\"paragraph\",\"content\":[{\"type\":\"text\",\"text\":\"Investigated the regression\"}]}]}}","Supply EITHER timeSpent (a string like '3h 20m') OR timeSpentSeconds (an integer), never both — supplying both is rejected.","Format 'started' exactly as yyyy-MM-ddTHH:mm:ss.SSS+0000 — milliseconds are required and the offset must be numeric (+0000), not 'Z'. This is the most common 400 on this endpoint.","Control the remaining estimate with the adjustEstimate query param: 'auto' (default, reduces remaining automatically), 'leave' (do not touch it), 'new' (requires newEstimate, e.g. ?adjustEstimate=new&newEstimate=2d), 'manual' (requires reduceBy, e.g. ?adjustEstimate=manual&reduceBy=1h).","Add &notifyUsers=false when back-filling worklogs in bulk to avoid spamming watchers.","Read worklogs back: GET /rest/api/3/issue/{issueIdOrKey}/worklog?startAt=0 — maxResults defaults to 5000 here. Narrow with startedAfter and startedBefore, which take UNIX millisecond timestamps.","Success on create is 201 with the created worklog object."],"gotchas":["The 'started' timestamp format is strict. Omitting milliseconds or using 'Z' instead of a numeric offset produces a 400 that does not clearly name the field.","adjustEstimate=new without newEstimate, or manual without reduceBy, returns 400.","The comment must be ADF in v3, not a plain string — same trap as issue comments.","A 413 means the per-issue worklog or attachment limit was breached; high-churn issues in long-running automations do hit this.","A 404 here can mean 'time tracking is disabled' rather than 'issue not found' — check the site config before debugging the issue key.","Docs: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-worklogs/"],"contributor":"mcs-route-factory","created":"2026-08-01T21:29:33.246Z","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":"unverified","method":"community-contrib","at":"2026-08-01T21:29:33.246Z"},"url":"https://mcp.waymark.network/r/bf05ed57-cefb-4d9e-9032-f3ff1cdc83c3"}