API Changelog - Rootly

June 2026

June 15, 2026

breaking: GET /v1/alerts no longer includes incidents, notified_users, responders, and groups by default. Use ?include=incidents,notified_users,responders,groups to request them. Show, create, update, and action endpoints are unchanged.
breaking: default sort order changed from descending to ascending for 16 endpoints: causes, custom_fields, environments, form_fields, form_field_placements, form_field_placement_conditions, functionalities, genius_tasks, genius_workflows, groups, incident_roles, incident_types, services, severities, catalog_entities, catalog_fields. Use sort=-position to restore previous behavior.
fix: pagination stability across 26 API v1 controllers by adding deterministic sorting tiebreakers (created_at, id) to prevent duplicate records across pages
fix: custom_forms endpoint now defaults to created_at sort (previously used non-existent position column)
feat: update permission sets for on-call roles, catalog entities, and group membership API resources

June 11, 2026

feat: return action item custom fields in API responses
feat: add ability to disable alert sources without deletion via enabled field
feat: expose IP address, user agent, and request ID in audit logs API

June 10, 2026

feat: accept custom field values on action items public API

June 8, 2026

fix: allow OAuth tokens to manage phone numbers, emails, and notification rules
fix: correct owner parameter on PATCH /v1/dashboards/:id
fix: email addresses index now properly scoped by user authorization

June 6, 2026

feat: add POST /v1/incidents/{id}/meeting_recordings/import endpoint

June 4, 2026

feat: expose Microsoft Teams and Webex meeting fields in incidents API

June 3, 2026

feat: add regex search support to API v1 endpoints
feat: add Google Chat space fields to escalation policy levels API
fix: schedule rotation update error for nil and invalid params
fix: limit escalation policies per owning team

June 2, 2026

feat: add Google Chat space fields to incidents API

June 1, 2026

feat: alert source fields update with new field attributes

May 2026

May 29, 2026

feat: allow attaching Functionalities to alerts via API
feat: add Cloudflare alert source

May 28, 2026

fix: /v1/users?include=teams now correctly scoped to calling workspace

May 27, 2026

fix: return 403 when API callers lack permission to manage group membership via user_ids/admin_ids

May 26, 2026

deprecated: source field on alert writes is now deprecated
feat: source and related incidents conditions support in alert routing API

May 22, 2026

feat: add per-report timezone settings to on-call pay reports API
feat: emit timestamped events on incident-side alert attach and detach

May 19, 2026

fix: allow started_at on status page events API

May 15, 2026

fix: filter[updated_at][gte] returning wrong results due to timezone mismatch
fix: escalation paths index endpoint

May 13, 2026

feat: cursor-based pagination for incidents API (page[after], page[before])
feat: add catalog permissions to on-call roles
fix: prevent user-less API keys from being set as schedule owner

May 12, 2026

feat: add API support for more schedule attributes
feat: add sort parameter to alert events feed endpoint

May 8, 2026

feat: add flat alert events feed endpoint (GET /v1/alert_events)
fix: return 422 when updating name on default escalation path

May 6, 2026

feat: add filter[team_ids] to escalation policies API
feat: allow escalating to a different escalation policy and resolved alerts
feat: add audit_log.created webhook event for SIEM integration
feat: add OAuth2/OIDC provider with scope-based authorization

May 5, 2026

feat: add updated_at field to Alerts API response

May 4, 2026

feat: expand audit log event types and improve display names
feat: add members_permissions RBAC for view/edit/delete members

April 2026

April 29, 2026

feat: incident bulk import API endpoint
fix: filter crashes from malformed query parameters in alerts index

April 28, 2026

feat: add Functionality as a valid notification target on alerts API
fix: preserve repeat_condition_* fields when omitted from PATCH requests

April 24, 2026

fix: GET /v1/users no longer returns duplicate records across pages

April 23, 2026

feat: add timezone and file download URLs to on-call pay report API
feat: allow live call routing phone tree with one escalation policy
fix: filter Slack channel writes from API/Terraform

April 22, 2026

feat: add pagination links to alerts API index_v2 responses
feat: add filter[notification_types] to /v1/oncalls

April 21, 2026

feat: cursor-based pagination for alerts API (page[after], page[before])
fix: RFC 3339 Z-suffix timestamps silently returning 0 results on API date filters

April 20, 2026

feat: add shift_shadow include to List Shifts endpoint
feat: add delete video (keep transcript) for meeting recordings API

April 16, 2026

feat: meeting recordings API with multi-session support and live transcription

April 15, 2026

fix: alert status changes via PATCH API bypassing timeline events and paging cancellation

April 13, 2026

fix: default escalation policy business hours timezone to organization timezone

April 10, 2026

feat: alert urgency support in alert workflows API

April 9, 2026

feat: add team-level scoping to Heartbeats API

April 8, 2026

feat: add REST API for managing API keys (GET/POST/PATCH/DELETE /v1/api_keys)
feat: add Dynatrace alert source
feat: add API endpoints for on-call pay report generation

April 6, 2026

feat: allow SLAs to be re-ordered via API

April 3, 2026

feat: add Functionality as a destination in alert grouping rules
feat: add functionality option for live call router and heartbeats paging

April 2, 2026

feat: add is_one_of and is_not_one_of operators to escalation path JSON rules

April 1, 2026

feat: add pagination support to List Shifts API endpoint
feat: add HMAC signature validation for generic webhook alert sources
fix: filter[search] being ignored on List Users endpoint
fix: 500 error on catalog_entity_checklists with invalid status filter

March 2026

March 31, 2026

fix: catalog API now returns 422 instead of 404 when scope_id is missing

March 27, 2026

feat: add support for catalog API search
fix: SLA API fixes for edge cases

March 26, 2026

fix: escalation policy default path API overwrites for Terraform applies
feat: simplify checklist template API
fix: updated_at filter not normalizing timestamps on incidents API
fix: external_domain_names not persisted via API/Terraform

March 25, 2026

feat: add API support for SLAs (GET/POST/PATCH/DELETE /v1/slas)

March 20, 2026

feat: publish catalog-related API schema changes

March 17, 2026

feat: add autoset trigger and catalog_entity_ids to form field selections API
feat: add custom fields filtering in incidents API (filter[custom_fields])

March 16, 2026

feat: add API for catalog entity checklists and audit triggers

March 13, 2026

feat: add REST API for catalog checklist templates
feat: retrigger alert when setting status via API
fix: escalation policy API fixes

March 11, 2026

feat: add group_ids filter to OnCalls API endpoint
feat: add escalation policy support to functionalities public API

March 9, 2026

feat: add preferred name field to User profile API

March 5, 2026

feat: implement PagerDuty-style /v1/oncalls API endpoint
feat: add 24-hour grace period for API key regeneration
fix: ensure rotation member positions are consecutive after API update

March 3, 2026

feat: add on-call shadow support within schedules API

March 2, 2026

feat: add better validation using schema on API endpoints

February 2026

February 27, 2026

feat: add filter[slack_channel_id] to GET /v1/incidents API
feat: add API endpoints for detach from parent and unmark as duplicate incidents
breaking: rename catalog fields API to properties (/v1/catalogs/:id/properties)

February 20, 2026

feat: update EscalationPolicyPaths API controller for deferral window CRUD

February 19, 2026

feat: add path_type filtering to escalation policy paths API index
feat: add deferral window rules to escalation policy paths API

February 17, 2026

feat: add deferred status filter to Alerts API

February 12, 2026

feat: support environment, causes, and incident type custom fields in API

February 11, 2026

fix: shifts user filter schedule nesting

February 9, 2026

fix: improve validation error messages on API responses

February 7, 2026

feat: make Edge Connector API JSON:API compatible

February 3, 2026

feat: add update_title field to status page templates API

February 1, 2026

feat: add escalation path field rule support in API

January 2026

January 29, 2026

deprecated: catalog entity properties API deprecated in favor of catalog properties
feat: support catalog fields in Environments API

January 27, 2026

feat: add is_editable and is_deletable attributes to API responses
feat: create /v1/:resource/fields APIs for resource field discovery
feat: allow filtering by name across API and Terraform endpoints

January 23, 2026

feat: allow resolving non-paging alerts via API
feat: add fields attribute to Services API
feat: update Communication Templates schema for Terraform compatibility

January 22, 2026

feat: add catalog_type to /v1/catalogs/:id/fields API
feat: add fields attribute to CatalogEntity API
feat: add auto_set_by_catalog_field_ids to form fields API
fix: slack_id returning same value for all teams in users API

January 21, 2026

feat: expose notification_type in notification rules API
feat: make Communication Template Stages API work for Terraform

January 20, 2026

fix: /v1/workflows API return responses

January 16, 2026

feat: add required attribute to catalog fields API

January 15, 2026

feat: API endpoint updates to support TipTap blocks for rich text

January 14, 2026

feat: allow overwriting schedule overrides via API
feat: add validation on alert source type matching notification system

January 13, 2026

feat: add configurable push notification sound for shift coverage requests

January 8, 2026

feat: add Rootly Edge Connector API

January 6, 2026

fix: restore requested_includes parameter for alert grouping associations

January 5, 2026

breaking: enforce application/vnd.api+json content type across all API endpoints
fix: API filter params with nil values no longer cause errors

December 2025

December 19, 2025

feat: add on-call role permissions to API
feat: add muted_service_ids to incidents API
feat: support alert fields and non-alert fields in alert source conditions
deprecated: legacy alert template attributes when alert fields are enabled

December 17, 2025

feat: add kubernetes_deployment_name to service creation API

December 16, 2025

breaking: remove undocumented alert grouping internal metadata fields from API response

December 15, 2025

feat: add escalation_policy_id to service API endpoint for Terraform compatibility

December 12, 2025

fix: ensure default business hours are applied when start/end times are blank
fix: delete existing resolution rule only if exists on alert source update

December 11, 2025

fix: alert grouping include parameters in alerts endpoint

December 10, 2025

feat: add API endpoint for incident statuses

December 5, 2025

feat: add assignee to shifts include options and deprecate user field
feat: add incident alerts to incident API response

December 3, 2025

feat: add created_by field to Incident AI API

November 2025

November 26, 2025

feat: add mitigation_message, resolution_message, and cancellation_message to incident update API

November 7, 2025

fix: remove timestamps from routing rule targets API response

November 6, 2025

feat: make slack_channel nullable in schedules API

November 4, 2025

feat: add slack_channel field to schedule endpoint

October 2025

October 30, 2025

feat: return UUID for custom_field_id in workflow custom field selections API

October 29, 2025

feat: make scheduled_for and scheduled_until fields not required, with auto defaults

October 28, 2025

fix: add rules back to alert routes API schema
feat: support large position values in API

October 14, 2025

feat: add additional information fields to Users API
feat: add auto_add_members_when_attached field to Teams API

October 10, 2025

feat: add project schedules support to schedules API

October 7, 2025

feat: add enhanced rotation details to schedule rotations API
fix: alert sources API schema validation errors

October 6, 2025

fix: add alert deduplication fields to alerts API response

October 3, 2025

fix: missing shifts in API response due to duplicate shift IDs by generating deterministic UUIDs

October 2, 2025

fix: timezone handling in escalation policy business_hours API

October 1, 2025

feat: include substatus name with ID for incidents API
feat: update schedule rotations API to support schedule rotation members
fix: shifts API to return all shifts including duplicates by ID
fix: shift start time to respect API query time range

September 2025

September 30, 2025

feat: implement SAML authentication API endpoints for status pages
feat: add email-based heartbeat pinging support
fix: postmortem template update from API

September 26, 2025

fix: correct turn start for hourly rotations crossing DST

September 25, 2025

fix: schedule members being null in API response

September 16, 2025

feat: add assignee_id and assignee_type to shifts API

September 12, 2025

fix: search filters not working in heartbeats API

September 11, 2025

feat: add content_raw field for markdown type post_mortem_templates
fix: missing rate limit headers in API responses

September 10, 2025

feat: add IANA timezone format to users API
fix: alert acknowledge/resolve endpoints to validate status transitions

September 9, 2025

feat: add alert_description field to heartbeats API

September 6, 2025

feat: add comprehensive API support for SAML authentication configuration

September 5, 2025

fix: schedule_rotation_users API uses shift rendering v2 if enabled

September 4, 2025

feat: add alert field values to alerts using API

September 3, 2025

fix: return 400 for malformed request body

August 2025

August 27, 2025

feat: added event sourcing for remote MCP source

August 22, 2025

feat: Alert Routes API endpoints

August 12, 2025

feat: add non-editable form fields option in forms API

August 7, 2025

fix: undefined reference to current_user.role in API responses

August 6, 2025

feat: allow owner/admin to manage UserNotificationRule for team members via API

August 4, 2025

fix: relax minimum escalation path restriction for Terraform
feat: add alert events to alerts API response

July 2025

July 31, 2025

feat: add custom fields and incident roles as columns in Table metrics panel API

July 28, 2025

feat: alert deduplication configuration, timeline events, and API endpoints

July 23, 2025

feat: email verification API endpoints

July 22, 2025

fix: include destination in alert routing rule API response
fix: rotation start/end timestamps now returned in UTC
feat: add disable auto adding members to incident channel feature in groups API

June 2025

June 4, 2025

fix: user_ids[] filtering on /v1/shifts endpoint
feat: add slug field to status pages API

June 2, 2025

feat: services API now accepts owner_group_ids parameter
fix: action items schema for assigned_to field
fix: ensure user contact info is created for correct user

May 2025

May 30, 2025

fix: delete prior sourceable when updating attributes from the API

May 28, 2025

feat: remove verification attributes from email/phone number APIs
feat: remove primary attribute from user email addresses API
feat: add case-insensitive target_type normalization

May 27, 2025

feat: add RESTful API endpoints for user phone numbers and email addresses

May 26, 2025

feat: add API support for advanced conditions in alert grouping

May 15, 2025

feat: allow automated invite of external emails into Slack incident channels

May 5, 2025

feat: add new escalate targets to public API schemas

April 2025

April 30, 2025

feat: ability to filter alerts by status via API

April 29, 2025

feat: return API timestamps in seconds

April 18, 2025

fix: API issue with assigning multiple users to role
feat: add initial_delay field to escalation policy API

April 15, 2025

fix: allow owner_group_ids parameter in API requests

April 9, 2025

fix: add missing urgency rules to alert sources API

April 8, 2025

feat: add email source settings to disable threaded emails

April 4, 2025

fix: typo in alert routes API

April 3, 2025

feat: team and organization API keys

March 2025

March 31, 2025

fix: API key search in audit logs section

March 28, 2025

feat: support resolution rule in alert source API

March 26, 2025

fix: specify required fields in routing rule schema
fix: routing rule schema fixes
fix: prevent crash from invalid SQL queries
fix: allow creating alert events with Rootly bot as user

March 25, 2025

feat: create/update/delete alert “note” events
feat: specify whether field can be computed in API schema

March 20, 2025

fix: alert routing API issues

March 17, 2025

feat: add API support for alert routes
fix: create cached Slack channel if necessary
feat: filter schedules and escalation policies by name
fix: validate and hydrate Slack channel targets
fix: return 422 for invalid record exceptions
fix: prevent duplicate active_times when updating rotation

March 14, 2025

feat: add business hours support to escalation policy API
fix: schedule rotation update should return errors
fix: respect requested escalation level position (breaking change)
fix: replace urgency rules when updating source (breaking change)
fix: do not prevent deletion of schedule rotations (breaking change)
fix: prevent duplicate schedule rotation active times

March 13, 2025

fix: support for escalation level paging strategy

March 11, 2025

feat: expose sub-status configuration on teams API

February 2025

February 26, 2025

fix: API alert sources webhooks endpoint URL

February 25, 2025

fix: alert sources tags and operationId API schema
feat: add API support to mark alerts as noise

February 17, 2025

feat: track last updated user for schedule rotations
feat: track last updated user for schedule rotation users

February 12, 2025

feat: API support for new escalation policy target type “team”

January 2025

January 30, 2025

feat: API support for group admin_ids

January 17, 2025

fix: schedules slack_user_group API schema

January 10, 2025

feat: API support for alert source urgency id and alert template

January 7, 2025

feat: API support for email alert creation

December 2024

December 2, 2024

fix: handle undocumented PagerDuty API schema

October 2024

October 23, 2024

feat: on-call shift calendar subscription

October 14, 2024

feat: handle “mitigated” status for workflow tasks when sub-status enabled
feat: add “Update Incident Status Timestamp” task to API schema

October 10, 2024

feat: allow sub_status_id for /v1/incidents/:id endpoint

October 1, 2024

feat: add missing API schema attribute for Terraform compatibility

September 25, 2024

feat: API support for sub-statuses

September 16, 2024

feat: expose alert urgency to POST api.rootly.com/v1/alerts

September 10, 2024

feat: add alert notification target on alert updates

September 4, 2024

feat: add API support for alert groups

August 30, 2024

feat: add API support for alert urgency

August 29, 2024

feat: add schedule rotation attributes to OpenAPI schema for Terraform compatibility
feat: add escalation policy path API support

July 19, 2024

fix: escalation policy OpenAPI schema and add service_ids, group_ids

July 2, 2024

fix: /api/v1/dashboards/:id returning 404 when shared publicly

Send AI chat messageSend a message to the AI assistant and receive a synchronous reply. Optionally bind the conversation to an incident or alert for context-aware responses. Requires `ai.chat:write` OAuth scope or an API key.

⌘I