v1
latestOpenAPI 3.0.02026-07-141,4077,1665.2 MBIncidents
Get a list of incident user-defined fields
Get a list of all incident user-defined fields.
get/api/v2/incidents/config/user-defined-fields
Query parameters
page[size]integer
The number of results to return per page. Must be between 0 and 1000.
page[number]integer
The page number to retrieve, starting at 0.
include-deletedboolean
When true, include soft-deleted fields in the response.
filter[incident-type]string
Filter results to fields associated with the given incident type UUID.
includestring
Comma-separated list of related resources to include. Supported values are "last_modified_by_user", "created_by_user", and "incident_type".
Response
OK
Example response
{
"data": [
{
"attributes": {
"category": "what_happened",
"collected": "active",
"created": "2026-03-18T08:40:05.185406Z",
"default_value": "critical",
"display_name": "Root Cause",
"metadata": {
"category": "teams_and_services",
"search_limit_param": "page[size]",
"search_query_param": "filter",
"search_result_path": "$.data[*].attributes.name",
"search_url": "/api/v2/incidents/config/services"
},
"modified": "2026-03-18T08:40:05.185406Z",
"name": "root_cause",
"ordinal": "1.5",
"type": 3,
"valid_values": [
{
"description": "A critical severity incident.",
"display_name": "Critical",
"short_description": "Critical",
"value": "critical"
}
]
},
"id": "00000000-0000-0000-0000-000000000000",
"relationships": {
"created_by_user": {
"data": {
"id": "00000000-0000-0000-2345-000000000000",
"type": "users"
}
},
"incident_type": {
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"type": "incident_types"
}
},
"last_modified_by_user": {
"data": {
"id": "00000000-0000-0000-2345-000000000000",
"type": "users"
}
}
},
"type": "user_defined_field"
}
],
"meta": {
"size": 5
}
}