Delete worklog

DELETE

/rest/api/3/issue/{issueIdOrKey}/worklog/{id}

Deletes a worklog from 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:

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.

Delete all worklogs project permission to delete any worklog or Delete own worklogs to delete worklogs created by the user,

If the worklog has visibility restrictions, belongs to the group or has the role visibility is restricted to.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'http://jira.local:8080/jira/rest//rest/api/3/issue//worklog/'

Response Example

204 - Example 1

{}

Request

Path Params

issueIdOrKey

string

required

The ID or key of the issue.

string

required

The ID of the worklog.

Query Params

notifyUsers

string

optional

Whether users watching the issue are notified by email.

adjustEstimate

string

optional

Defines 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 Increases the estimate by amount specified in increaseBy.

auto Reduces the estimate by the value of timeSpent in the worklog.

newEstimate

string

optional

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.

increaseBy

string

optional

The amount to increase the issue's remaining estimate by, as days (#d), hours (#h), or minutes (#m or #). For example, 2d. Required when adjustEstimate is manual.

overrideEditableFlag

string

optional

Whether the work log 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. Connect and Forge app users with admin permission can use this flag.

Responses

🟢204Returned if the request is successful.

application/json

Body

object {0}

🟠400Returned if: * `adjustEstimate` is set to `new` but `newEstimate` is not provided or is invalid. * `adjustEstimate` is set to `manual` but `reduceBy` is not provided or is invalid. * the user does not have permission to delete the worklog.

🟠401Returned if the authentication credentials are incorrect.

🟠404Returned if: * the issue is not found or user does not have permission to view the issue. * the worklog is not found or the user does not have permission to view it. * time tracking is disabled.

Modified at 2023-07-13 03:27:27

Update worklog

Get IDs of deleted worklogs