POST
/
v1
/
alerts
/
{alert_id}
/
events
curl --request POST \
  --url https://api.rootly.com/v1/alerts/{alert_id}/events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '{
  "data": {
    "type": "alert_events",
    "attributes": {
      "kind": "note",
      "user_id": 123,
      "details": "<string>"
    }
  }
}'
{
  "data": {
    "id": "f2183182-343c-4e29-99fe-d0459e2c73b5",
    "type": "alert_events",
    "attributes": {
      "kind": "note",
      "source": "api",
      "action": "created",
      "details": "This is a test note",
      "user": {
        "id": 6,
        "email": "bot@rootly.com",
        "deleted_at": null,
        "created_at": "2025-03-31T05:59:07.446-07:00",
        "updated_at": "2025-03-31T05:59:07.446-07:00",
        "current_team_id": 2,
        "first_name": "Rootly",
        "last_name": null,
        "time_zone": "America/Los_Angeles",
        "last_seen_at": null,
        "profile_photo_id": null,
        "ability_cache": null,
        "last_notification_email_sent_at": null,
        "accept_terms": true,
        "onboarding_completed": true,
        "service_user": true,
        "accept_marketing": true,
        "teams_count": 1,
        "created_through_sso": false,
        "scim_uid": null,
        "session_token": null,
        "incidents_example_count": 0,
        "incidents_test_count": 0,
        "incidents_normal_count": 0,
        "incidents_scheduled_count": 0,
        "incidents_backfilled_count": 0,
        "incidents_count": 0,
        "theme": "light_v2",
        "skip_tutorial": false,
        "external_id": null,
        "jti": "30ea6f18-0641-45cb-8be2-c4209e166d4e",
        "is_super_admin": false,
        "has_impersonate_write_permission": false,
        "view_multiple_schedules": true,
        "push_notification_new_alert_sound": "default",
        "push_notification_shift_starts_sound": "soft_bloob",
        "push_notification_shift_ends_sound": "soft_bloob",
        "how_did_you_hear_about_us": null,
        "push_notification_new_alert_volume": 1,
        "opsgenie_id": null,
        "victor_ops_id": null,
        "pagerduty_id": null
      },
      "user_id": 6,
      "incident": null,
      "schedule": null,
      "escalation_level": null,
      "escalation_target_type": null,
      "escalation_target": null,
      "slack_channel": null,
      "incident_ids": [],
      "created_at": "2025-03-31T05:59:08.935-07:00",
      "updated_at": "2025-03-31T05:59:08.935-07:00"
    }
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

alert_id
string
required

Body

application/vnd.api+json
data
object
required

Response

201
application/vnd.api+json
alert event created with Rootly bot user
data
object
required