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
Creates an environment
Environments
Creates an environment
Creates a new environment from provided data
POST
/
v1
/
environments
curl --request POST \
--url https://api.rootly.com/v1/environments \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
--header 'content-type: application/vnd.api+json'
{
"data": {
"id": "8c20e74a-a641-4d7a-8f1e-703937f5777b",
"type": "environments",
"attributes": {
"slug": "us-east-1",
"name": "us-east-1",
"description": "East Coast Datacenter",
"color": "#FFF",
"position": 1,
"notify_emails": [
"hello@rootly.com",
"world@rootly.com"
],
"slack_channels": [
{
"id": "C03MKDSEJE8",
"name": "elastisearch"
}
],
"slack_aliases": [
{
"id": "S03F7QUV7F1",
"name": "leadership"
}
],
"created_at": "2025-03-11T19:09:26.258-07:00",
"updated_at": "2025-03-11T19:09:26.258-07:00"
}
}
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
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
201
application/vnd.api+json
environment created
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 POST \
--url https://api.rootly.com/v1/environments \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
--header 'content-type: application/vnd.api+json'
{
"data": {
"id": "8c20e74a-a641-4d7a-8f1e-703937f5777b",
"type": "environments",
"attributes": {
"slug": "us-east-1",
"name": "us-east-1",
"description": "East Coast Datacenter",
"color": "#FFF",
"position": 1,
"notify_emails": [
"hello@rootly.com",
"world@rootly.com"
],
"slack_channels": [
{
"id": "C03MKDSEJE8",
"name": "elastisearch"
}
],
"slack_aliases": [
{
"id": "S03F7QUV7F1",
"name": "leadership"
}
],
"created_at": "2025-03-11T19:09:26.258-07:00",
"updated_at": "2025-03-11T19:09:26.258-07:00"
}
}
}