Update Worklog
PUT {{baseUrl}}/rest/api/3/issue/:issueIdOrKey/worklog/:id?notifyUsers=true&adjustEstimate=auto&newEstimate=<string>&expand=&overrideEditableFlag=false
Updates a worklog.
Time tracking must be enabled in Jira, otherwise this operation returns an error. For more information, see Configuring time tracking.
This operation can be accessed anonymously.
Permissions required:
- Browse projects project permission for the project that the issue is in.
- If issue-level security is configured, issue-level security permission to view the issue.
- Edit all worklogs project permission to update any worklog or Edit own worklogs to update worklogs created by the user.
- If the worklog has visibility restrictions, belongs to the group or has the role visibility is restricted to.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
notifyUsers | boolean | Whether users watching the issue are notified by email. | |
adjustEstimate | string | Defines how to update the issue's time estimate, the options are: |
new
Sets the estimate to a specific value, defined innewEstimate
.leave
Leaves the estimate unchanged.auto
Updates the estimate by the difference between the original and updated value oftimeSpent
ortimeSpentSeconds
. | |newEstimate
| string | | The value to set as the issue's remaining time estimate, as days (#d), hours (#h), or minutes (#m or #). For example, 2d. Required whenadjustEstimate
isnew
. | |expand
| null | | Use expand to include additional information about worklogs in the response. This parameter acceptsproperties
, which returns worklog properties. | |overrideEditableFlag
| boolean | | Whether the worklog should be added to the issue even if the issue is not editable. For example, because the issue is closed. Only connect app users with admin permissions can use this flag. |
Request Body
{"visibility"=>{"type"=>"<string>", "value"=>"<string>"}, "started"=>"<dateTime>", "timeSpent"=>"<string>", "timeSpentSeconds"=>"<long>", "properties"=>[{"key"=>"<string>"}, {"key"=>"<string>"}]}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string |
RESPONSES
status: OK
{"self":"https://your-domain.atlassian.net/rest/api/3/issue/10010/worklog/10000","author":{"self":"https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g","accountId":"5b10a2844c20165700ede21g","displayName":"Mia Krystof","active":false},"updateAuthor":{"self":"https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g","accountId":"5b10a2844c20165700ede21g","displayName":"Mia Krystof","active":false},"comment":{"type":"doc","version":1,"content":[{"type":"paragraph","content":[{"type":"text","text":"I did some work here."}]}]},"updated":"2020-12-17T01:45:40.269+0000","visibility":{"type":"group","value":"jira-developers"},"started":"2020-12-17T01:45:40.269+0000","timeSpent":"3h 20m","timeSpentSeconds":12000,"id":"100028","issueId":"10002"}