Creates a Form Field Placement

curl --request POST \ --url https://api.rootly.com/v1/form_fields/{form_field_id}/placements \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/vnd.api+json' \ --data ' { "data": { "type": "form_field_placements", "attributes": { "form_set_id": "<string>", "form": "<string>", "position": 123, "required": true, "required_operator": "and", "placement_operator": "and", "non_editable": true } } } '

{ "data": { "id": "f0ed6372-9600-4f1c-8174-0bcf8d7c0547", "type": "form_field_placements", "attributes": { "form_field_id": "561c8bce-0b98-4642-bfa6-c138b0bdf047", "form_set_id": "9e40eef0-8e26-4835-8262-2a9d8200cf29", "form": "slack_new_incident_form", "position": 1, "required": false, "placement_operator": "and", "required_operator": "and", "non_editable": true } } }

Authorizations

Authorization

string

header

required

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

Path Parameters

form_field_id

string

required

Body

application/vnd.api+json

data

object

required

Show child attributes

data.type

enum<string>

required

Available options:

form_field_placements

data.attributes

object

required

Show child attributes

data.attributes.form_set_id

string

required

The form set this field is placed in.

data.attributes.form

string

required

The form this field is placed on.

data.attributes.position

integer

The position of the field placement.

data.attributes.required

boolean

Whether the field is unconditionally required on this form.

data.attributes.required_operator

enum<string>

Logical operator when evaluating multiple form_field_placement_conditions with conditioned=required

Available options:

and,

or

data.attributes.placement_operator

enum<string>

Logical operator when evaluating multiple form_field_placement_conditions with conditioned=placement

Available options:

and,

or

data.attributes.non_editable

boolean

Whether the field is read-only and cannot be edited by users.

Response

form_field_placement created with non_editable true

data

object

required

Show child attributes

data.id

string

required

Unique ID of the form field placement

data.type

enum<string>

required

Available options:

form_field_placements

data.attributes

object

required

Show child attributes

data.attributes.form_field_id

string

required

The form field that is placed.

data.attributes.form_set_id

string

required

The form set this field is placed in.

data.attributes.form

string

required

The form this field is placed on.

data.attributes.position

integer

required

The position of the field placement.

data.attributes.required

boolean

required

Whether the field is unconditionally required on this form.

data.attributes.required_operator

enum<string>

Logical operator when evaluating multiple form_field_placement_conditions with conditioned=required

Available options:

and,

or

data.attributes.placement_operator

enum<string>

Logical operator when evaluating multiple form_field_placement_conditions with conditioned=placement

Available options:

and,

or

data.attributes.non_editable

boolean

Whether the field is read-only and cannot be edited by users.

Overview

AlertEvents

AlertFields

AlertGroups

AlertRoutes

AlertRoutingRules

AlertUrgencies

AlertSources

Alerts

Audits

Authorizations

CatalogEntities

CatalogEntityProperties

CatalogFields

Catalogs

Causes

Communications Groups

Communications Stages

Communications Templates

Communications Types

[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

IpRanges

LiveCallRouters

OnCallRoles

OnCallShadows

OverrideShifts

PlaybookTasks

Playbooks

RetrospectiveTemplates

Pulses

RetrospectiveConfigurations

RetrospectiveProcessGroupSteps

RetrospectiveProcessGroups

RetrospectiveProcesses

RetrospectiveSteps

Roles

ScheduleRotationActiveDays