Note : This endpoint is in preview and is subject to change.
If you have any feedback, contact Datadog support .
POST https://api.ap1.datadoghq.com/api/v2/cases/views https://api.ap2.datadoghq.com/api/v2/cases/views https://api.datadoghq.eu/api/v2/cases/views https://api.ddog-gov.com/api/v2/cases/views https://api.us2.ddog-gov.com/api/v2/cases/views https://api.datadoghq.com/api/v2/cases/views https://api.us3.datadoghq.com/api/v2/cases/views https://api.us5.datadoghq.com/api/v2/cases/views
Overview Creates a new saved case view with a name, filter query, and associated project. Optionally, a notification rule can be linked to the view.
OAuth apps require the cases_write authorization scope to access this endpoint.
Request Body Data (required) Case view payload.
Expand All
Data object for creating a case view.
Attributes required to create a case view.
The identifier of a notification rule linked to this view. When set, users subscribed to the view receive alerts for matching cases.
The UUID of the project this view belongs to. Views are scoped to a single project.
The query used to filter cases in this view.
JSON:API resource type for case views.
Allowed enum values: view
default: view
{
"data" : {
"attributes" : {
"name" : "Open bugs" ,
"np_rule_id" : "string" ,
"project_id" : "e555e290-ed65-49bd-ae18-8acbfcf18db7" ,
"query" : "status:open type:bug"
},
"type" : "view"
}
} Response Created
Response containing a single case view.
Expand All
A saved case view that provides a filtered, reusable list of cases matching a specific query. Views act as persistent dashboards for monitoring case subsets.
Attributes of a case view, including the filter query and optional notification rule.
Timestamp when the view was created.
Timestamp when the view was last modified.
A human-readable name for the view, displayed in the Case Management UI.
The identifier of a notification rule linked to this view. When set, users subscribed to the view receive alerts for matching cases.
The search query that determines which cases appear in this view. Uses the same syntax as the Case Management search bar (for example, status:open priority:P1).
Related resources for the case view, including the creator, last modifier, and associated project.
Relationship to user object.
A unique identifier that represents the user.
User resource type.
Allowed enum values: user
default: user
Relationship to user object.
A unique identifier that represents the user.
User resource type.
Allowed enum values: user
default: user
Relationship to project object.
A unique identifier that represents the project.
Project resource type.
Allowed enum values: project
default: project
JSON:API resource type for case views.
Allowed enum values: view
default: view
{
"data" : {
"attributes" : {
"created_at" : "2024-01-01T00:00:00.000Z" ,
"modified_at" : "2019-09-19T10:00:00.000Z" ,
"name" : "Open bugs" ,
"np_rule_id" : "string" ,
"query" : "status:open type:bug"
},
"id" : "a1b2c3d4-e5f6-7890-abcd-ef1234567890" ,
"relationships" : {
"created_by" : {
"data" : {
"id" : "00000000-0000-0000-0000-000000000000" ,
"type" : "user"
}
},
"modified_by" : {
"data" : {
"id" : "00000000-0000-0000-0000-000000000000" ,
"type" : "user"
}
},
"project" : {
"data" : {
"id" : "e555e290-ed65-49bd-ae18-8acbfcf18db7" ,
"type" : "project"
}
}
},
"type" : "view"
}
} Bad Request
{
"errors" : [
"Bad Request"
]
} Unauthorized
{
"errors" : [
"Bad Request"
]
} Forbidden
{
"errors" : [
"Bad Request"
]
} Not Found
{
"errors" : [
"Bad Request"
]
} Too many requests
{
"errors" : [
"Bad Request"
]
} Code Example Copy
## default
#
# Curl command curl -X POST "https://api.ap1.datadoghq.com "https://api.ap2.datadoghq.com "https://api.datadoghq.eu "https://api.ddog-gov.com "https://api.us2.ddog-gov.com "https://api.datadoghq.com "https://api.us3.datadoghq.com "https://api.us5.datadoghq.com /api/v2/cases/views " \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY} " \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY} " \
-d @- << EOF
{
"data": {
"attributes": {
"name": "Open bugs",
"project_id": "e555e290-ed65-49bd-ae18-8acbfcf18db7",
"query": "status:open type:bug"
},
"type": "view"
}
}
EOF
