Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/vnd.api+json
Response
cause created
Creates a new cause from provided data
curl --request POST \
--url https://api.rootly.com/v1/causes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '{
"data": {
"type": "causes",
"attributes": {
"name": "<string>",
"description": "<string>",
"position": 123
}
}
}'{
"data": {
"id": "dd7f5ad9-35bd-4446-a5cd-bc8da3badfb9",
"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-11-05T02:03:07.268-08:00",
"updated_at": "2025-11-05T02:03:07.268-08:00"
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Show child attributes
cause created
Show child attributes
Was this page helpful?
curl --request POST \
--url https://api.rootly.com/v1/causes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '{
"data": {
"type": "causes",
"attributes": {
"name": "<string>",
"description": "<string>",
"position": 123
}
}
}'{
"data": {
"id": "dd7f5ad9-35bd-4446-a5cd-bc8da3badfb9",
"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-11-05T02:03:07.268-08:00",
"updated_at": "2025-11-05T02:03:07.268-08:00"
}
}
}