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
[DEPRECATED] Creates a custom field option
[DEPRECATED] Creates a custom field option
[DEPRECATED] Use form field endpoints instead. Creates a new custom field option from provided data
POST
/
v1
/
custom_fields
/
{custom_field_id}
/
options
curl --request POST \
--url https://api.rootly.com/v1/custom_fields/{custom_field_id}/options \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '{
"data": {
"type": "custom_field_options",
"attributes": {
"value": "<string>",
"color": "<string>",
"default": true,
"position": 123
}
}
}'
{
"data": {
"id": "3",
"type": "custom_field_options",
"attributes": {
"custom_field_id": 1,
"value": "Test option value",
"color": "#FBE4A0",
"default": false,
"position": 3,
"updated_at": "2025-03-28T22:58:44.503-07:00",
"created_at": "2025-03-28T22:58:44.503-07:00"
}
}
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
Body
application/vnd.api+json
Available options:
custom_field_options
Response
201
application/vnd.api+json
custom_field_option created
Unique ID of the custom_field_option
Available options:
custom_field_options
The value of the custom_field_option
The hex color of the custom_field_option
The position of the custom_field_option
Date of creation
Date of last update
The ID of the parent custom field
Was this page helpful?
curl --request POST \
--url https://api.rootly.com/v1/custom_fields/{custom_field_id}/options \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '{
"data": {
"type": "custom_field_options",
"attributes": {
"value": "<string>",
"color": "<string>",
"default": true,
"position": 123
}
}
}'
{
"data": {
"id": "3",
"type": "custom_field_options",
"attributes": {
"custom_field_id": 1,
"value": "Test option value",
"color": "#FBE4A0",
"default": false,
"position": 3,
"updated_at": "2025-03-28T22:58:44.503-07:00",
"created_at": "2025-03-28T22:58:44.503-07:00"
}
}
}