Overview

Work item approvals let you request sign-off from one or more team members before taking action on a work item, supporting change management workflows. This feature is available on all standard and custom work types. All approval activity is tracked in the work item’s activity timeline.

Requesting approvals

To request approval on a work item:

1. From a work item, click the More Options icon on the right-hand side.
2. Select Request approval.
3. Use the Add reviewer dropdown to select one or more users.
4. (Optional) Enter a message in the Describe your request field.
5. Click Request.

Note: The request cannot be edited after any reviewer has responded.

After requesting approval, a Reviewers section appears in the work item details panel. Each reviewer’s name and current status (Requested, Approved, or Declined) is displayed. To modify the reviewers list, click the edit icon next to Reviewers. All approval events are recorded in the work item’s activity timeline.

Notifications

• Approvers are notified by email when their approval is requested.
• The requester is notified each time an approval or decline is received.

Permissions

For more information, see Datadog Role Permissions.

Automation rules

You can trigger work item automation rules based on work item approval events. For instance, you can trigger a workflow to automatically update a work item status once all approvals are received.

Available triggers include:

• First, each, or all approvals a work item receives
• First or each decline a work item receives

See Work item automation rules for setup instructions.

Further reading

Additional helpful documentation, links, and articles:

Work item automation rulesDOCUMENTATION Work ManagementDOCUMENTATION