POST
/
v1
/
incidents
/
{incident_id}
/
form_field_selections
Creates an incident form field selection
curl --request POST \
  --url https://api.rootly.com/v1/incidents/{incident_id}/form_field_selections \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '{
  "data": {
    "type": "incident_form_field_selections",
    "attributes": {
      "incident_id": "<string>",
      "form_field_id": "<string>",
      "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": "3c1438f2-205d-469b-a424-8d9e813131bf",
    "type": "incident_form_field_selections",
    "attributes": {
      "incident_id": "b11e1976-32dc-4b62-b43d-614ace893145",
      "custom_field_id": 176,
      "form_field_id": "78937766-c400-4be9-84f6-34a9f4753e07",
      "form_field": {
        "id": "78937766-c400-4be9-84f6-34a9f4753e07",
        "team_id": 186,
        "slug": "itaque-qui-tenetur-doloribus",
        "kind": "custom",
        "input_kind": "text",
        "value_kind": "inherit",
        "value_kind_catalog_id": null,
        "name": "Itaque qui tenetur doloribus.",
        "description": "Occaecati nostrum architecto quia.",
        "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-07-09T12:21:00.308-07:00",
        "created_at": "2025-07-09T12:21:00.308-07:00",
        "options": [
          {
            "id": "e9813fa8-8550-4ac8-866f-9823eb773e68",
            "form_field_id": "78937766-c400-4be9-84f6-34a9f4753e07",
            "value": "Consequatur non dignissimos ut.",
            "color": "#FBE4A0",
            "default": false,
            "position": 1,
            "updated_at": "2025-07-09T12:21:00.404-07:00",
            "created_at": "2025-07-09T12:21:00.404-07:00"
          },
          {
            "id": "821a8889-3697-4103-980f-72a5bad3e258",
            "form_field_id": "78937766-c400-4be9-84f6-34a9f4753e07",
            "value": "Aliquam temporibus et consequatur.",
            "color": "#FBE4A0",
            "default": false,
            "position": 2,
            "updated_at": "2025-07-09T12:21:00.409-07:00",
            "created_at": "2025-07-09T12:21:00.409-07:00"
          }
        ],
        "positions": [
          {
            "id": "fcc4ed86-c841-4cfc-8219-0043bbe779fe",
            "form_field_id": "78937766-c400-4be9-84f6-34a9f4753e07",
            "form": "web_new_incident_form",
            "position": 2
          },
          {
            "id": "a183aa06-5ee7-495b-a69e-665a9ddc2af2",
            "form_field_id": "78937766-c400-4be9-84f6-34a9f4753e07",
            "form": "slack_new_incident_form",
            "position": 2
          },
          {
            "id": "eacdaae0-9a66-4cfb-afd3-007e546a5ce4",
            "form_field_id": "78937766-c400-4be9-84f6-34a9f4753e07",
            "form": "web_update_incident_form",
            "position": 2
          },
          {
            "id": "197c4876-ae5e-4493-8971-c6b4a7b8dd7a",
            "form_field_id": "78937766-c400-4be9-84f6-34a9f4753e07",
            "form": "slack_update_incident_form",
            "position": 2
          }
        ]
      },
      "value": "Test custom field",
      "selected_group_ids": [],
      "selected_groups": {
        "id": null,
        "value": "Test custom field"
      },
      "selected_option_ids": [],
      "selected_options": {
        "id": null,
        "value": "Test custom field"
      },
      "selected_service_ids": [],
      "selected_services": {
        "id": null,
        "value": "Test custom field"
      },
      "selected_functionality_ids": [],
      "selected_functionalities": {
        "id": null,
        "value": "Test custom field"
      },
      "selected_catalog_entity_ids": [],
      "selected_catalog_entities": {
        "id": null,
        "value": "Test custom field"
      },
      "selected_user_ids": [],
      "selected_users": {
        "id": null,
        "value": "Test custom field"
      }
    }
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

incident_id
string
required

Body

application/vnd.api+json

Response

201
application/vnd.api+json

incident_form_field_selection created

The response is of type object.