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": "9a5988d4-29d3-4e2b-9ad9-8a260f8ab813",
"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-12-10T06:08:09.751-08:00",
"updated_at": "2025-12-10T06:08:09.751-08:00"
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Show child attributes
cause created
Show child attributes
Unique ID of the cause
causes Show child attributes
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 <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '
{
"data": {
"type": "causes",
"attributes": {
"name": "<string>",
"description": "<string>",
"position": 123
}
}
}
'{
"data": {
"id": "9a5988d4-29d3-4e2b-9ad9-8a260f8ab813",
"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-12-10T06:08:09.751-08:00",
"updated_at": "2025-12-10T06:08:09.751-08:00"
}
}
}