Overview
Reference
- AlertEvents
- AlertGroups
- AlertUrgencies
- AlertSources
- Alerts
- Audits
- Authorizations
- CatalogEntities
- CatalogEntityProperties
- CatalogFields
- Catalogs
- Causes
- [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
- ScheduleRotationUsers
- ScheduleRotations
- Schedules
- Shifts
- Secrets
- Services
- Severities
- StatusPageTemplates
- StatusPages
- SubStatuses
- Teams
- UserNotificationRules
- Users
- WebhooksDeliveries
- WebhooksEndpoints
Environments
Update an environment
Environments
Update an environment
Update a specific environment by id
PUT
/
v1
/
environments
/
{id}
curl --request PUT \
--url https://api.rootly.com/v1/environments/%7Bid%7D \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
--header 'content-type: application/vnd.api+json'
{
"data": {
"id": "9cfa4cfb-76b6-4950-ad18-3566b058a387",
"type": "environments",
"attributes": {
"slug": "us-east-1",
"name": "us-east-1",
"description": "East Coast Datacenter Region 1",
"color": "#000",
"position": 2,
"notify_emails": [],
"slack_channels": [],
"slack_aliases": [],
"created_at": "2025-03-11T19:09:23.812-07:00",
"updated_at": "2025-03-11T19:09:27.383-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:
environments
The name of the environment
The description of the environment
The hex color of the environment
Position of the environment
Emails to attach to the environment
Response
200
application/vnd.api+json
environment updated
Unique ID of the environment
Available options:
environments
The name of the environment
Date of creation
Date of last update
The slug of the environment
The description of the environment
Emails attached to the environment
The hex color of the environment
Position of the environment
Was this page helpful?
curl --request PUT \
--url https://api.rootly.com/v1/environments/%7Bid%7D \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
--header 'content-type: application/vnd.api+json'
{
"data": {
"id": "9cfa4cfb-76b6-4950-ad18-3566b058a387",
"type": "environments",
"attributes": {
"slug": "us-east-1",
"name": "us-east-1",
"description": "East Coast Datacenter Region 1",
"color": "#000",
"position": 2,
"notify_emails": [],
"slack_channels": [],
"slack_aliases": [],
"created_at": "2025-03-11T19:09:23.812-07:00",
"updated_at": "2025-03-11T19:09:27.383-07:00"
}
}
}