Note : This endpoint is in preview and is subject to change.
If you have any feedback, contact Datadog support .
PUT https://api.ap1.datadoghq.com/api/v2/cases/views/{view_id} https://api.ap2.datadoghq.com/api/v2/cases/views/{view_id} https://api.datadoghq.eu/api/v2/cases/views/{view_id} https://api.ddog-gov.com/api/v2/cases/views/{view_id} https://api.us2.ddog-gov.com/api/v2/cases/views/{view_id} https://api.datadoghq.com/api/v2/cases/views/{view_id} https://api.us3.datadoghq.com/api/v2/cases/views/{view_id} https://api.us5.datadoghq.com/api/v2/cases/views/{view_id}
Overview Updates the name, query, or notification rule of an existing case view.
OAuth apps require the cases_write authorization scope to access this endpoint.
Arguments Path Parameters The UUID of the case view.
Request Body Data (required) Case view payload.
Expand All
Data object for updating a case view.
Attributes that can be updated on a case view. All fields are optional; only provided fields are changed.
The identifier of a notification rule linked to this view. When set, users subscribed to the view receive alerts for matching cases.
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" : "string" ,
"np_rule_id" : "string" ,
"query" : "string"
},
"type" : "view"
}
} Response OK
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
#
# Path parameters export view_id = "a1b2c3d4-e5f6-7890-abcd-ef1234567890" # Curl command curl -X PUT "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/${view_id} " \
-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": "Updated view name"
},
"type": "view"
}
}
EOF
