Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/vnd.api+json
Response
pulse created
Creates a new pulse from provided data
curl --request POST \
--url https://api.rootly.com/v1/pulses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '{
"data": {
"type": "pulses",
"attributes": {
"source": "<string>",
"summary": "<string>",
"service_ids": [
"<string>"
],
"environment_ids": [
"<string>"
],
"started_at": "2023-11-07T05:31:56Z",
"ended_at": "2023-11-07T05:31:56Z",
"external_url": "<string>",
"labels": [
{
"key": "<string>",
"value": "<string>"
}
],
"refs": [
{
"key": "<string>",
"value": "<string>"
}
],
"data": {}
}
}
}'
{
"data": {
"id": "17a88b5d-ace9-4e25-a643-76843df23013",
"type": "pulses",
"attributes": {
"short_id": null,
"source": "k8s",
"summary": "Deploy k8s",
"labels": [
{
"key": "status",
"value": "succeeded"
}
],
"refs": [
{
"key": "sha",
"value": "cd62148cbc5eb42168fe99fdb50a364e12b206ac"
},
{
"key": "image",
"value": "registry.rootly.com/rootly/my-service:cd6214"
}
],
"services": [
{
"id": "b6ceb88d-5cc6-403d-9303-ddd0f1931da4",
"alert_broadcast_channel": {},
"alert_broadcast_enabled": false,
"alert_urgency_id": null,
"alerts_email_address": "service-0631a0cdec41fee80bca8ced6f0947ed@email.rootly.com",
"alerts_email_enabled": false,
"backstage_id": null,
"color": "#D7F5E1",
"cortex_id": null,
"created_at": "2025-10-23T10:00:41.880-07:00",
"datadog_id": null,
"deleted_at": null,
"description": "Aperiam corporis molestiae ut.",
"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": "Quod est doloremque minus.",
"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": "quod-est-doloremque-minus",
"status": "operational",
"team_id": 342,
"updated_at": "2025-10-23T10:00:41.880-07:00"
}
],
"environments": [
{
"id": "676db29f-15db-44be-9f39-38ffda1243ac",
"color": "#b102b1",
"created_at": "2025-10-23T10:00:41.893-07:00",
"deleted_at": null,
"description": "Voluptatem dolores molestias quo.",
"external_id": null,
"incidents_count": 0,
"name": "Dolorem neque ipsum quos.",
"notify_emails": [],
"position": 1,
"slack_aliases": [],
"slack_channels": [],
"slug": "dolorem-neque-ipsum-quos",
"team_id": 342,
"updated_at": "2025-10-23T10:00:41.893-07:00"
}
],
"data": {
"url": "https://additionaldata.com"
},
"external_url": "https://external-url.com",
"started_at": "2025-10-23T09:51:59.000-07:00",
"ended_at": "2025-10-23T09:53:59.000-07:00",
"created_at": "2025-10-23T10:00:43.136-07:00",
"updated_at": "2025-10-23T10:00:43.136-07:00"
}
}
}
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Show child attributes
pulse created
Show child attributes
Was this page helpful?
curl --request POST \
--url https://api.rootly.com/v1/pulses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '{
"data": {
"type": "pulses",
"attributes": {
"source": "<string>",
"summary": "<string>",
"service_ids": [
"<string>"
],
"environment_ids": [
"<string>"
],
"started_at": "2023-11-07T05:31:56Z",
"ended_at": "2023-11-07T05:31:56Z",
"external_url": "<string>",
"labels": [
{
"key": "<string>",
"value": "<string>"
}
],
"refs": [
{
"key": "<string>",
"value": "<string>"
}
],
"data": {}
}
}
}'
{
"data": {
"id": "17a88b5d-ace9-4e25-a643-76843df23013",
"type": "pulses",
"attributes": {
"short_id": null,
"source": "k8s",
"summary": "Deploy k8s",
"labels": [
{
"key": "status",
"value": "succeeded"
}
],
"refs": [
{
"key": "sha",
"value": "cd62148cbc5eb42168fe99fdb50a364e12b206ac"
},
{
"key": "image",
"value": "registry.rootly.com/rootly/my-service:cd6214"
}
],
"services": [
{
"id": "b6ceb88d-5cc6-403d-9303-ddd0f1931da4",
"alert_broadcast_channel": {},
"alert_broadcast_enabled": false,
"alert_urgency_id": null,
"alerts_email_address": "service-0631a0cdec41fee80bca8ced6f0947ed@email.rootly.com",
"alerts_email_enabled": false,
"backstage_id": null,
"color": "#D7F5E1",
"cortex_id": null,
"created_at": "2025-10-23T10:00:41.880-07:00",
"datadog_id": null,
"deleted_at": null,
"description": "Aperiam corporis molestiae ut.",
"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": "Quod est doloremque minus.",
"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": "quod-est-doloremque-minus",
"status": "operational",
"team_id": 342,
"updated_at": "2025-10-23T10:00:41.880-07:00"
}
],
"environments": [
{
"id": "676db29f-15db-44be-9f39-38ffda1243ac",
"color": "#b102b1",
"created_at": "2025-10-23T10:00:41.893-07:00",
"deleted_at": null,
"description": "Voluptatem dolores molestias quo.",
"external_id": null,
"incidents_count": 0,
"name": "Dolorem neque ipsum quos.",
"notify_emails": [],
"position": 1,
"slack_aliases": [],
"slack_channels": [],
"slug": "dolorem-neque-ipsum-quos",
"team_id": 342,
"updated_at": "2025-10-23T10:00:41.893-07:00"
}
],
"data": {
"url": "https://additionaldata.com"
},
"external_url": "https://external-url.com",
"started_at": "2025-10-23T09:51:59.000-07:00",
"ended_at": "2025-10-23T09:53:59.000-07:00",
"created_at": "2025-10-23T10:00:43.136-07:00",
"updated_at": "2025-10-23T10:00:43.136-07:00"
}
}
}