Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/vnd.api+json
Response
alert created
Creates a new alert from provided data
curl --request POST \
--url https://api.rootly.com/v1/alerts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '{
"data": {
"type": "alerts",
"attributes": {
"noise": "noise",
"source": "rootly",
"status": "open",
"summary": "<string>",
"description": "<string>",
"service_ids": [
"<string>"
],
"group_ids": [
"<string>"
],
"environment_ids": [
"<string>"
],
"started_at": "2023-11-07T05:31:56Z",
"ended_at": "2023-11-07T05:31:56Z",
"external_id": "<string>",
"external_url": "<string>",
"alert_urgency_id": "<string>",
"notification_target_type": "User",
"notification_target_id": "<string>",
"labels": [
{
"key": "<string>",
"value": "<string>"
}
],
"data": {},
"deduplication_key": "<string>",
"alert_field_values_attributes": [
{
"alert_field_id": "<string>",
"value": "<string>"
}
]
}
}
}'
{
"data": {
"id": "1e18f74a-abe3-44f3-94cd-f7e3eaad37f6",
"type": "alerts",
"attributes": {
"short_id": null,
"source": "asana",
"status": "open",
"summary": "Asana ticket created",
"description": null,
"labels": [
{
"key": "status",
"value": "succeeded"
}
],
"services": [
{
"id": "ce66a29d-f4d3-4309-b2e7-01fab0dfba2a",
"alert_broadcast_channel": {},
"alert_broadcast_enabled": false,
"alert_urgency_id": null,
"alerts_email_address": "service-dc2db362bbb19db01842ed445c78e0ee@email.rootly.com",
"alerts_email_enabled": false,
"backstage_id": null,
"color": "#F4CFD1",
"cortex_id": null,
"created_at": "2025-10-07T00:15:22.759-07:00",
"datadog_id": null,
"deleted_at": null,
"description": "Cum ducimus voluptas facilis.",
"external_id": null,
"github_repository_branch": "master",
"github_repository_name": null,
"gitlab_repository_branch": "master",
"gitlab_repository_name": null,
"heroku_app_name": null,
"incident_broadcast_channel": {},
"incident_broadcast_enabled": false,
"incidents_count": 0,
"kubernetes_deployment_name": null,
"name": "Ex id iusto enim.",
"notify_emails": [],
"opsgenie_id": null,
"opsgenie_team_id": null,
"opslevel_id": null,
"pagerduty_id": null,
"position": 1,
"public_description": null,
"service_now_ci_sys_id": null,
"show_uptime": true,
"show_uptime_last_days": 60,
"slack_aliases": [],
"slack_channels": [],
"slug": "ex-id-iusto-enim",
"status": "operational",
"team_id": 21,
"updated_at": "2025-10-07T00:15:22.759-07:00"
}
],
"service_ids": [
"ce66a29d-f4d3-4309-b2e7-01fab0dfba2a"
],
"groups": [],
"group_ids": [],
"environments": [
{
"id": "691fca3d-6206-4b51-bcc3-422c84d7e9f8",
"color": "#1c1c36",
"created_at": "2025-10-07T00:15:22.782-07:00",
"deleted_at": null,
"description": "Et et eligendi ipsum.",
"external_id": null,
"incidents_count": 0,
"name": "Officiis quibusdam sit et.",
"notify_emails": [],
"position": 1,
"slack_aliases": [],
"slack_channels": [],
"slug": "officiis-quibusdam-sit-et",
"team_id": 21,
"updated_at": "2025-10-07T00:15:22.782-07:00"
}
],
"environment_ids": [
"691fca3d-6206-4b51-bcc3-422c84d7e9f8"
],
"responders": [],
"incidents": [],
"data": {
"url": "https://asana.com/issues/1"
},
"deduplication_key": null,
"started_at": "2025-10-07T00:12:27.000-07:00",
"ended_at": "2025-10-07T00:14:27.000-07:00",
"external_id": null,
"external_url": null,
"url": "https://test.rootly.com/account/alerts/1e18f74a-abe3-44f3-94cd-f7e3eaad37f6",
"noise": "not_noise",
"notification_target_type": null,
"notification_target_id": null,
"alert_urgency": {
"id": "2d65f45e-96e3-4971-9b99-9ee6a75b1b73",
"color": "#C73C40",
"created_at": "2025-10-07T00:15:22.792-07:00",
"deleted_at": null,
"description": "Qui quos corporis consectetur.",
"name": "w2p64",
"position": 1,
"team_id": 21,
"updated_at": "2025-10-07T00:15:22.797-07:00",
"urgency": "high"
},
"alert_urgency_id": "2d65f45e-96e3-4971-9b99-9ee6a75b1b73",
"notified_users": [],
"created_at": "2025-10-07T00:15:24.580-07:00",
"updated_at": "2025-10-07T00:15:24.580-07:00"
},
"relationships": {
"events": {
"data": [
{
"id": "e6d9b220-6eb9-496d-9685-5ad2810128fd",
"type": "alert_events"
}
]
}
}
}
}
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Show child attributes
alert created
Show child attributes
Was this page helpful?
curl --request POST \
--url https://api.rootly.com/v1/alerts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '{
"data": {
"type": "alerts",
"attributes": {
"noise": "noise",
"source": "rootly",
"status": "open",
"summary": "<string>",
"description": "<string>",
"service_ids": [
"<string>"
],
"group_ids": [
"<string>"
],
"environment_ids": [
"<string>"
],
"started_at": "2023-11-07T05:31:56Z",
"ended_at": "2023-11-07T05:31:56Z",
"external_id": "<string>",
"external_url": "<string>",
"alert_urgency_id": "<string>",
"notification_target_type": "User",
"notification_target_id": "<string>",
"labels": [
{
"key": "<string>",
"value": "<string>"
}
],
"data": {},
"deduplication_key": "<string>",
"alert_field_values_attributes": [
{
"alert_field_id": "<string>",
"value": "<string>"
}
]
}
}
}'
{
"data": {
"id": "1e18f74a-abe3-44f3-94cd-f7e3eaad37f6",
"type": "alerts",
"attributes": {
"short_id": null,
"source": "asana",
"status": "open",
"summary": "Asana ticket created",
"description": null,
"labels": [
{
"key": "status",
"value": "succeeded"
}
],
"services": [
{
"id": "ce66a29d-f4d3-4309-b2e7-01fab0dfba2a",
"alert_broadcast_channel": {},
"alert_broadcast_enabled": false,
"alert_urgency_id": null,
"alerts_email_address": "service-dc2db362bbb19db01842ed445c78e0ee@email.rootly.com",
"alerts_email_enabled": false,
"backstage_id": null,
"color": "#F4CFD1",
"cortex_id": null,
"created_at": "2025-10-07T00:15:22.759-07:00",
"datadog_id": null,
"deleted_at": null,
"description": "Cum ducimus voluptas facilis.",
"external_id": null,
"github_repository_branch": "master",
"github_repository_name": null,
"gitlab_repository_branch": "master",
"gitlab_repository_name": null,
"heroku_app_name": null,
"incident_broadcast_channel": {},
"incident_broadcast_enabled": false,
"incidents_count": 0,
"kubernetes_deployment_name": null,
"name": "Ex id iusto enim.",
"notify_emails": [],
"opsgenie_id": null,
"opsgenie_team_id": null,
"opslevel_id": null,
"pagerduty_id": null,
"position": 1,
"public_description": null,
"service_now_ci_sys_id": null,
"show_uptime": true,
"show_uptime_last_days": 60,
"slack_aliases": [],
"slack_channels": [],
"slug": "ex-id-iusto-enim",
"status": "operational",
"team_id": 21,
"updated_at": "2025-10-07T00:15:22.759-07:00"
}
],
"service_ids": [
"ce66a29d-f4d3-4309-b2e7-01fab0dfba2a"
],
"groups": [],
"group_ids": [],
"environments": [
{
"id": "691fca3d-6206-4b51-bcc3-422c84d7e9f8",
"color": "#1c1c36",
"created_at": "2025-10-07T00:15:22.782-07:00",
"deleted_at": null,
"description": "Et et eligendi ipsum.",
"external_id": null,
"incidents_count": 0,
"name": "Officiis quibusdam sit et.",
"notify_emails": [],
"position": 1,
"slack_aliases": [],
"slack_channels": [],
"slug": "officiis-quibusdam-sit-et",
"team_id": 21,
"updated_at": "2025-10-07T00:15:22.782-07:00"
}
],
"environment_ids": [
"691fca3d-6206-4b51-bcc3-422c84d7e9f8"
],
"responders": [],
"incidents": [],
"data": {
"url": "https://asana.com/issues/1"
},
"deduplication_key": null,
"started_at": "2025-10-07T00:12:27.000-07:00",
"ended_at": "2025-10-07T00:14:27.000-07:00",
"external_id": null,
"external_url": null,
"url": "https://test.rootly.com/account/alerts/1e18f74a-abe3-44f3-94cd-f7e3eaad37f6",
"noise": "not_noise",
"notification_target_type": null,
"notification_target_id": null,
"alert_urgency": {
"id": "2d65f45e-96e3-4971-9b99-9ee6a75b1b73",
"color": "#C73C40",
"created_at": "2025-10-07T00:15:22.792-07:00",
"deleted_at": null,
"description": "Qui quos corporis consectetur.",
"name": "w2p64",
"position": 1,
"team_id": 21,
"updated_at": "2025-10-07T00:15:22.797-07:00",
"urgency": "high"
},
"alert_urgency_id": "2d65f45e-96e3-4971-9b99-9ee6a75b1b73",
"notified_users": [],
"created_at": "2025-10-07T00:15:24.580-07:00",
"updated_at": "2025-10-07T00:15:24.580-07:00"
},
"relationships": {
"events": {
"data": [
{
"id": "e6d9b220-6eb9-496d-9685-5ad2810128fd",
"type": "alert_events"
}
]
}
}
}
}