Class CaseManagementApi

Adds one or more insights to a work item. Insights are references to related Datadog resources (such as monitors, security signals, incidents, or error tracking issues) that provide investigative context. Up to 100 insights can be added per request. Each insight requires a type (see CaseInsightType for allowed values), a ref (URL path to the resource), and a resource_id.

Performs an aggregation query over work items, grouping results by specified fields and returning counts per group along with a total. Useful for dashboards and analytics.

Archive work item

Assign work item to a user

Applies a single action (such as changing priority, status, assignment, or archiving) to multiple work items at once. The list of work item IDs and the action type with its payload are specified in the request body.

Add a comment to a work item.

Returns work item counts, optionally grouped by one or more fields (for example, status, priority). Supports a query filter to narrow the scope.

Create a work item

Creates an automation rule for a project. The rule defines a trigger event (for example, work item created, status transitioned) and an action to execute.

Create a new Jira issue and link it to a work item

Creates a directional link between two work items (for example, work item A blocks work item B). The parent and child work items and their relationship type must be specified.

Create a new investigation notebook and link it to a work item

Create a new ServiceNow incident ticket and link it to a work item

Creates a new saved work item view with a name, filter query, and associated project. Optionally, a notification rule can be linked to the view.

Creates a maintenance window for event management work items with a name, work item filter query, and time range (start and end).

Create a project.

Create a notification rule for a project.

Permanently deletes an automation rule from a project.

Delete work item comment

Delete custom attribute from work item

Deletes an existing link between work items by link ID.

Permanently deletes a saved work item view.

Permanently deletes a maintenance window.

Remove a project using the project's id.

Delete a notification rule using the notification rule's id.

Disables an automation rule so it no longer triggers on work item events. The rule configuration is preserved.

Enables a previously disabled automation rule so it triggers on matching work item events.

Marks a Work Management project as a favorite for the current authenticated user.

Get the details of a work item by case_id.

Returns a single automation rule identified by its UUID, including its trigger, action, and current state (enabled/disabled).

Returns a single saved work item view identified by its UUID, including its query, associated project, and timestamps.

Get the details of a project by project_id.

Get all notification rules for a project.

Get all projects.

Link an incident to a work item

Link an existing Jira issue to a work item

Returns all automation rules configured for a project. Automation rules allow automatic actions to be triggered by work item events like creation, status transitions, or attribute changes.

Returns all links associated with a work item. Links define relationships (for example, BLOCKS) between work items. Requires entity_type and entity_id query parameters.

Returns the timeline of events for a work item, including comments, status changes, and other activity. Supports pagination and sort order.

Returns all saved work item views for a given project. Views are saved search queries that allow quick access to filtered lists of work items.

Returns the list of users who are watching a work item. Watchers receive notifications about updates to the work item.

Returns all configured maintenance windows for event management work items. Maintenance windows define time periods during which work item notifications and automation rules are suppressed for work items matching a given query.

Returns the list of Work Management projects that the current authenticated user has marked as favorites.

Update the project associated with a work item

Removes one or more previously added insights from a work item by specifying their type and resource identifier in the request body.

Search work items.

Provide a paginated version of searchCases returning a generator with all the items.

Unarchive work item

Unassign work item

Removes a Work Management project from the current user's favorites list.

Remove the link between a Jira issue and a work item

Removes a user from the watchers list of a work item. The user no longer receives notifications about updates to the work item.

Update work item attributes

Updates the trigger, action, name, or state of an existing automation rule.

Updates the text content of an existing comment on a work item timeline. The comment is identified by its cell ID.

Update work item custom attribute

Update work item description

Sets or updates the due date for a work item. The due date is a calendar date (without a time component) indicating when the work item should be resolved.

Sets the resolved reason for a security work item (for example, FALSE_POSITIVE, TRUE_POSITIVE). Applicable to security-type work items.

Update work item title

Updates the name, query, or notification rule of an existing work item view.

Updates the name, query, start time, or end time of an existing maintenance window.

Update work item priority

Update a project.

Update a notification rule.

Update work item status

Adds a user (identified by their UUID) as a watcher of a work item. The user receives notifications about subsequent updates to the work item.