Add Worklog

POST {{baseUrl}}/rest/api/3/issue/:issueIdOrKey/worklog?notifyUsers=true&adjustEstimate=auto&newEstimate=<string>&reduceBy=<string>&expand=&overrideEditableFlag=false

Adds a worklog to an issue.

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:

Request Params

KeyDatatypeRequiredDescription
notifyUsersbooleanWhether users watching the issue are notified by email.
adjustEstimatestringDefines how to update the issue's time estimate, the options are:
  • new Sets the estimate to a specific value, defined in newEstimate.
  • leave Leaves the estimate unchanged.
  • manual Reduces the estimate by amount specified in reduceBy.
  • auto Reduces the estimate by the value of timeSpent in the worklog. | | 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 when adjustEstimate is new. | | reduceBy | string | | The amount to reduce the issue's remaining estimate by, as days (#d), hours (#h), or minutes (#m). For example, 2d. Required when adjustEstimate is manual. | | expand | null | | Use expand to include additional information about work logs in the response. This parameter accepts properties, which returns worklog properties. | | overrideEditableFlag | boolean | | Whether the worklog entry should be added to the issue even if the issue is not editable, because jira.issue.editable set to false or missing. For example, the issue is closed. Only connect app users with admin scope permission can use this flag. |

Request Body

{"visibility"=>{"type"=>"<string>", "value"=>"<string>"}, "started"=>"<dateTime>", "timeSpent"=>"<string>", "timeSpentSeconds"=>"<long>", "properties"=>[{"key"=>"<string>"}, {"key"=>"<string>"}]}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring

RESPONSES

status: Created

{&quot;self&quot;:&quot;http://gCY.fkfGmZL.bC5M&quot;,&quot;author&quot;:{&quot;self&quot;:&quot;laboris ut deserunt&quot;,&quot;name&quot;:&quot;Excepteur dolore consectetur l&quot;,&quot;key&quot;:&quot;voluptate sed&quot;,&quot;accountId&quot;:&quot;ea &quot;,&quot;emailAddress&quot;:&quot;esse exercitation sint aute magna&quot;,&quot;avatarUrls&quot;:{&quot;16x16&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;24x24&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;32x32&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;48x48&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},&quot;displayName&quot;:&quot;dolor laboris sint&quot;,&quot;active&quot;:false,&quot;timeZone&quot;:&quot;ad&quot;,&quot;accountType&quot;:&quot;irure voluptate veniam&quot;},&quot;updateAuthor&quot;:{&quot;self&quot;:&quot;labore dese&quot;,&quot;name&quot;:&quot;sunt proident mollit&quot;,&quot;key&quot;:&quot;Ut nulla commodo eu ani&quot;,&quot;accountId&quot;:&quot;par&quot;,&quot;emailAddress&quot;:&quot;elit&quot;,&quot;avatarUrls&quot;:{&quot;16x16&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;24x24&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;32x32&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;48x48&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},&quot;displayName&quot;:&quot;reprehenderit sit et nostrud&quot;,&quot;active&quot;:true,&quot;timeZone&quot;:&quot;id incididunt reprehenderit&quot;,&quot;accountType&quot;:&quot;dolor&quot;},&quot;comment&quot;:{},&quot;created&quot;:&quot;2012-12-03T01:15:55.700Z&quot;,&quot;updated&quot;:&quot;1960-11-06T14:29:52.666Z&quot;,&quot;visibility&quot;:{&quot;type&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;},&quot;started&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;timeSpent&quot;:&quot;\u003cstring\u003e&quot;,&quot;timeSpentSeconds&quot;:&quot;\u003clong\u003e&quot;,&quot;id&quot;:&quot;commodo proident aliqua in&quot;,&quot;issueId&quot;:&quot;qui consequat dolor sunt laboris&quot;,&quot;properties&quot;:[{&quot;key&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{}},{&quot;key&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:{}}]}