Class CaseManagementApi

Adds one or more insights to a case. 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 cases, grouping results by specified fields and returning counts per group along with a total. Useful for dashboards and analytics.

Archive case

Assign case to a user

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

Comment case

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

Create a Case

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

Create a new Jira issue and link it to a case

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

Create a new investigation notebook and link it to a case

Create a new ServiceNow incident ticket and link it to a case

Creates a new saved case 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 cases with a name, case 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 case comment

Delete custom attribute from case

Deletes an existing link between cases by link ID.

Permanently deletes a saved case 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 case events. The rule configuration is preserved.

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

Marks a case project as a favorite for the current authenticated user.

Get the details of case 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 case 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 case

Link an existing Jira issue to a case

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

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

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

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

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

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

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

Update the project associated with a case

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

Search cases.

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

Unarchive case

Unassign case

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

Remove the link between a Jira issue and a case

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

Update case attributes

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

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

Update case custom attribute

Update case description

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

Sets the resolved reason for a security case (for example, FALSE_POSITIVE, TRUE_POSITIVE). Applicable to security-type cases.

Update case title

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

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

Update case priority

Update a project.

Update a notification rule.

Update case status

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