Overview
AlertEvents
AlertGroups
AlertRoutingRules
AlertUrgencies
AlertSources
Alerts
Audits
Authorizations
CatalogEntities
CatalogEntityProperties
CatalogFields
Catalogs
[DEPRECATED] CustomFieldOptions
[DEPRECATED] CustomFields
CustomForms
DashboardPanels
Dashboards
Environments
EscalationPolicies
EscalationLevelsPolicies
EscalationLevelsPath
EscalationLevels
EscalationPaths
FormFieldOptions
FormFieldPlacementConditions
FormFieldPlacements
FormFieldPositions
FormFields
FormSetConditions
FormSets
Functionalities
WorkflowTasks
[DEPRECATED] WorkflowCustomFieldSelections
WorkflowFormFieldConditions
WorkflowGroups
WorkflowRuns
Workflows
Heartbeats
IncidentActionItems
[DEPRECATED] IncidentCustomFieldSelections
IncidentEventFunctionalities
IncidentEventServices
IncidentEvents
IncidentFeedbacks
IncidentFormFieldSelections
IncidentPermissionSetBooleans
IncidentPermissionSetResources
IncidentPermissionSets
IncidentRetrospectives
IncidentRetrospectiveSteps
IncidentRoleTasks
IncidentRoles
IncidentStatusPageEvents
IncidentSubStatuses
IncidentTypes
Incidents
- GETList incidents
- POSTCreates an incident
- GETRetrieves an incident
- PUTUpdate an incident
- DELDelete an incident
- PUTMitigate an incident
- PUTResolve an incident
- PUTCancel an incident
- PUTTriage an incident
- PUTRestart an incident
- PUTMark an incident as a duplicate
- POSTAdd subscribers to incident
- DELRemove subscribers from incident
- POSTAssign user to incident
- DELRemove assigned user from incident
IpRanges
LiveCallRouters
OnCallRoles
OnCallShadows
OverrideShifts
PlaybookTasks
Playbooks
RetrospectiveTemplates
RetrospectiveConfigurations
RetrospectiveProcessGroupSteps
RetrospectiveProcessGroups
RetrospectiveProcesses
RetrospectiveSteps
ScheduleRotationActiveDays
ScheduleRotationUsers
ScheduleRotations
Schedules
Services
Severities
StatusPageTemplates
StatusPages
SubStatuses
Teams
UserNotificationRules
WebhooksDeliveries
Update an incident form field selection
Update a specific incident form field selection by id
curl --request PUT \
--url https://api.rootly.com/v1/incident_form_field_selections/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '{
"data": {
"type": "incident_form_field_selections",
"attributes": {
"value": "<string>",
"selected_catalog_entity_ids": [
"<string>"
],
"selected_group_ids": [
"<string>"
],
"selected_option_ids": [
"<string>"
],
"selected_service_ids": [
"<string>"
],
"selected_functionality_ids": [
"<string>"
],
"selected_user_ids": [
123
]
}
}
}'
{
"data": {
"id": "2798c528-3510-41e4-9543-ad1804e79d7c",
"type": "incident_form_field_selections",
"attributes": {
"incident_id": "c4d739e2-296c-4153-bf5e-10fc8ed86ad3",
"custom_field_id": 31,
"form_field_id": "dafeaee9-dda2-4ec9-b56d-126bc49adef4",
"form_field": {
"id": "dafeaee9-dda2-4ec9-b56d-126bc49adef4",
"team_id": 198,
"slug": "fuga-optio-rerum-aut",
"kind": "custom",
"input_kind": "text",
"value_kind": "inherit",
"value_kind_catalog_id": null,
"name": "Fuga optio rerum aut.",
"description": "Eius est alias et.",
"shown": [
"web_new_incident_form",
"web_update_incident_form",
"slack_new_incident_form",
"slack_update_incident_form"
],
"required": [],
"default_values": [],
"show_on_incident_details": true,
"enabled": true,
"updated_at": "2025-03-28T23:01:30.110-07:00",
"created_at": "2025-03-28T23:01:30.110-07:00",
"options": [
{
"id": "c30ec4e0-e690-405a-aab5-7390456003c7",
"form_field_id": "dafeaee9-dda2-4ec9-b56d-126bc49adef4",
"value": "Consequatur quam explicabo et.",
"color": "#FBE4A0",
"default": false,
"position": 1,
"updated_at": "2025-03-28T23:01:30.172-07:00",
"created_at": "2025-03-28T23:01:30.172-07:00"
},
{
"id": "37d81135-b281-4e92-baf3-dbec977d1187",
"form_field_id": "dafeaee9-dda2-4ec9-b56d-126bc49adef4",
"value": "Quos quibusdam explicabo ut.",
"color": "#FBE4A0",
"default": false,
"position": 2,
"updated_at": "2025-03-28T23:01:30.175-07:00",
"created_at": "2025-03-28T23:01:30.175-07:00"
}
],
"positions": [
{
"id": "3e91b2fe-4839-40af-ac54-73cb4dbb6ef5",
"form_field_id": "dafeaee9-dda2-4ec9-b56d-126bc49adef4",
"form": "slack_new_incident_form",
"position": 1
},
{
"id": "31b1a6aa-2671-4cfe-ba0d-b1a83dcbc57c",
"form_field_id": "dafeaee9-dda2-4ec9-b56d-126bc49adef4",
"form": "web_update_incident_form",
"position": 1
},
{
"id": "f70ea5f1-890a-4f0f-bae2-500495e1b1c4",
"form_field_id": "dafeaee9-dda2-4ec9-b56d-126bc49adef4",
"form": "slack_update_incident_form",
"position": 1
},
{
"id": "a5d03f2f-41f8-42c2-b0a9-140dd2f178d3",
"form_field_id": "dafeaee9-dda2-4ec9-b56d-126bc49adef4",
"form": "web_new_incident_form",
"position": 1
}
]
},
"value": "Test update custom field",
"selected_group_ids": [],
"selected_groups": {
"id": null,
"value": "Test update custom field"
},
"selected_option_ids": [],
"selected_options": {
"id": null,
"value": "Test update custom field"
},
"selected_service_ids": [],
"selected_services": {
"id": null,
"value": "Test update custom field"
},
"selected_functionality_ids": [],
"selected_functionalities": {
"id": null,
"value": "Test update custom field"
},
"selected_catalog_entity_ids": [],
"selected_catalog_entities": {
"id": null,
"value": "Test update custom field"
},
"selected_user_ids": [],
"selected_users": {
"id": null,
"value": "Test update custom field"
}
}
}
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
Body
incident_form_field_selections
The selected value for text kind custom fields
The selected catalog entities for select and multi_select kinds
The selected groups (teams) for select and multi_select kinds
The selected options for select and multi_select kinds
The selected services for select and multi_select kinds
The selected functionalities for select and multi_select kinds
The selected users for select and multi_select kinds
Response
Unique ID of the incident_form_field_selection
incident_form_field_selections
The custom field for this selection
The selected value for text kind custom fields
The selected catalog entities for select and multi_select kinds
The selected groups (teams) for select and multi_select kinds
The selected options for select and multi_select kinds
The selected services for select and multi_select kinds
The selected functionalities for select and multi_select kinds
The selected users for select and multi_select kinds
curl --request PUT \
--url https://api.rootly.com/v1/incident_form_field_selections/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '{
"data": {
"type": "incident_form_field_selections",
"attributes": {
"value": "<string>",
"selected_catalog_entity_ids": [
"<string>"
],
"selected_group_ids": [
"<string>"
],
"selected_option_ids": [
"<string>"
],
"selected_service_ids": [
"<string>"
],
"selected_functionality_ids": [
"<string>"
],
"selected_user_ids": [
123
]
}
}
}'
{
"data": {
"id": "2798c528-3510-41e4-9543-ad1804e79d7c",
"type": "incident_form_field_selections",
"attributes": {
"incident_id": "c4d739e2-296c-4153-bf5e-10fc8ed86ad3",
"custom_field_id": 31,
"form_field_id": "dafeaee9-dda2-4ec9-b56d-126bc49adef4",
"form_field": {
"id": "dafeaee9-dda2-4ec9-b56d-126bc49adef4",
"team_id": 198,
"slug": "fuga-optio-rerum-aut",
"kind": "custom",
"input_kind": "text",
"value_kind": "inherit",
"value_kind_catalog_id": null,
"name": "Fuga optio rerum aut.",
"description": "Eius est alias et.",
"shown": [
"web_new_incident_form",
"web_update_incident_form",
"slack_new_incident_form",
"slack_update_incident_form"
],
"required": [],
"default_values": [],
"show_on_incident_details": true,
"enabled": true,
"updated_at": "2025-03-28T23:01:30.110-07:00",
"created_at": "2025-03-28T23:01:30.110-07:00",
"options": [
{
"id": "c30ec4e0-e690-405a-aab5-7390456003c7",
"form_field_id": "dafeaee9-dda2-4ec9-b56d-126bc49adef4",
"value": "Consequatur quam explicabo et.",
"color": "#FBE4A0",
"default": false,
"position": 1,
"updated_at": "2025-03-28T23:01:30.172-07:00",
"created_at": "2025-03-28T23:01:30.172-07:00"
},
{
"id": "37d81135-b281-4e92-baf3-dbec977d1187",
"form_field_id": "dafeaee9-dda2-4ec9-b56d-126bc49adef4",
"value": "Quos quibusdam explicabo ut.",
"color": "#FBE4A0",
"default": false,
"position": 2,
"updated_at": "2025-03-28T23:01:30.175-07:00",
"created_at": "2025-03-28T23:01:30.175-07:00"
}
],
"positions": [
{
"id": "3e91b2fe-4839-40af-ac54-73cb4dbb6ef5",
"form_field_id": "dafeaee9-dda2-4ec9-b56d-126bc49adef4",
"form": "slack_new_incident_form",
"position": 1
},
{
"id": "31b1a6aa-2671-4cfe-ba0d-b1a83dcbc57c",
"form_field_id": "dafeaee9-dda2-4ec9-b56d-126bc49adef4",
"form": "web_update_incident_form",
"position": 1
},
{
"id": "f70ea5f1-890a-4f0f-bae2-500495e1b1c4",
"form_field_id": "dafeaee9-dda2-4ec9-b56d-126bc49adef4",
"form": "slack_update_incident_form",
"position": 1
},
{
"id": "a5d03f2f-41f8-42c2-b0a9-140dd2f178d3",
"form_field_id": "dafeaee9-dda2-4ec9-b56d-126bc49adef4",
"form": "web_new_incident_form",
"position": 1
}
]
},
"value": "Test update custom field",
"selected_group_ids": [],
"selected_groups": {
"id": null,
"value": "Test update custom field"
},
"selected_option_ids": [],
"selected_options": {
"id": null,
"value": "Test update custom field"
},
"selected_service_ids": [],
"selected_services": {
"id": null,
"value": "Test update custom field"
},
"selected_functionality_ids": [],
"selected_functionalities": {
"id": null,
"value": "Test update custom field"
},
"selected_catalog_entity_ids": [],
"selected_catalog_entities": {
"id": null,
"value": "Test update custom field"
},
"selected_user_ids": [],
"selected_users": {
"id": null,
"value": "Test update custom field"
}
}
}
}