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": "81594b97-c2a6-450a-ad3a-cd2a0133b010",
    "type": "incident_form_field_selections",
    "attributes": {
      "incident_id": "ba0dc7fe-1b34-4b04-9699-c2aa4841f6b8",
      "custom_field_id": 177,
      "form_field_id": "62f8e234-629f-4f7b-8a5e-37e1eb4669c4",
      "form_field": {
        "id": "62f8e234-629f-4f7b-8a5e-37e1eb4669c4",
        "team_id": 187,
        "slug": "quisquam-voluptatem-fugiat-expedita",
        "kind": "custom",
        "input_kind": "text",
        "value_kind": "inherit",
        "value_kind_catalog_id": null,
        "name": "Quisquam voluptatem fugiat expedita.",
        "description": "Est exercitationem voluptatem cumque.",
        "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-08-04T22:30:25.106-07:00",
        "created_at": "2025-08-04T22:30:25.106-07:00",
        "options": [
          {
            "id": "5f0d81ba-d971-46f9-bedb-cbde6f242b6b",
            "form_field_id": "62f8e234-629f-4f7b-8a5e-37e1eb4669c4",
            "value": "Rem aliquid sit sunt.",
            "color": "#FBE4A0",
            "default": false,
            "position": 1,
            "updated_at": "2025-08-04T22:30:25.174-07:00",
            "created_at": "2025-08-04T22:30:25.174-07:00"
          },
          {
            "id": "3d931157-bd71-4432-81fd-96e9e2495c14",
            "form_field_id": "62f8e234-629f-4f7b-8a5e-37e1eb4669c4",
            "value": "Praesentium qui quia laudantium.",
            "color": "#FBE4A0",
            "default": false,
            "position": 2,
            "updated_at": "2025-08-04T22:30:25.178-07:00",
            "created_at": "2025-08-04T22:30:25.178-07:00"
          }
        ],
        "positions": [
          {
            "id": "52d9d159-b8d3-4847-bbad-d39b293ff8fe",
            "form_field_id": "62f8e234-629f-4f7b-8a5e-37e1eb4669c4",
            "form": "web_new_incident_form",
            "position": 2
          },
          {
            "id": "3b9df814-9f6f-494e-8aa6-7a7e8affa118",
            "form_field_id": "62f8e234-629f-4f7b-8a5e-37e1eb4669c4",
            "form": "slack_new_incident_form",
            "position": 2
          },
          {
            "id": "6fce2809-987b-4cbd-8355-8106a488b150",
            "form_field_id": "62f8e234-629f-4f7b-8a5e-37e1eb4669c4",
            "form": "web_update_incident_form",
            "position": 2
          },
          {
            "id": "b5f00a6d-746a-451f-9e8c-fd9e048bde74",
            "form_field_id": "62f8e234-629f-4f7b-8a5e-37e1eb4669c4",
            "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.