> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rootly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Changelog

> Track the latest changes, deprecations, and breaking updates to the Rootly API, including new endpoints, payload changes, and version release notes.

## 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

***