v4

latestOpenAPI 3.0.1Apache 2.02026-08-016169702.3 MB
Issue worklogs

Bulk delete worklogs

Deletes a list of worklogs from an issue. This is an experimental API with limitations:

  • You can't delete more than 5000 worklogs at once.
  • No notifications will be sent for deleted worklogs.

Time tracking must be enabled in Jira, otherwise this operation returns an error. For more information, see Configuring time tracking.

Permissions required:

  • Browse projects project permission for the project containing the issue.
  • If issue-level security is configured, issue-level security permission to view the issue.
  • Delete all worklogs project permission to delete any worklog.
  • If any worklog has visibility restrictions, belongs to the group or has the role visibility is restricted to.
delete/rest/api/3/issue/{issueIdOrKey}/worklog

Path parameters

issueIdOrKeystring required

The ID or key of the issue.

Query parameters

adjustEstimate'leave' | 'auto'

Defines how to update the issue's time estimate, the options are:

  • leave Leaves the estimate unchanged.
  • auto Reduces the estimate by the aggregate value of timeSpent across all worklogs being deleted.
overrideEditableFlagboolean

Whether the work log entries should be removed 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.

Request body

idsinteger[] required

A list of worklog IDs.

Response

Returned if the bulk deletion request was partially successful, with a message indicating partial success.