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
Causes
Creates a cause
Causes
Creates a cause
Creates a new cause from provided data
POST
/
v1
/
causes
curl --request POST \
--url https://api.rootly.com/v1/causes \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
--header 'content-type: application/vnd.api+json'
{
"data": {
"id": "d6c4fda5-0dcc-4435-b26d-9f834165be92",
"type": "causes",
"attributes": {
"slug": "how-to-handle-customer-facing-incident",
"name": "How to handle customer-facing incident?",
"description": "This is a description",
"position": 1,
"created_at": "2025-03-13T11:59:31.447-07:00",
"updated_at": "2025-03-13T11:59:31.447-07:00"
}
}
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/vnd.api+json
Response
201
application/vnd.api+json
cause created
Unique ID of the cause
Available options:
causes
The name of the cause
Date of creation
Date of last update
The slug of the cause
The description of the cause
Position of the cause
Was this page helpful?
curl --request POST \
--url https://api.rootly.com/v1/causes \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
--header 'content-type: application/vnd.api+json'
{
"data": {
"id": "d6c4fda5-0dcc-4435-b26d-9f834165be92",
"type": "causes",
"attributes": {
"slug": "how-to-handle-customer-facing-incident",
"name": "How to handle customer-facing incident?",
"description": "This is a description",
"position": 1,
"created_at": "2025-03-13T11:59:31.447-07:00",
"updated_at": "2025-03-13T11:59:31.447-07:00"
}
}
}