API Changelog

New endpoints, new fields, deprecations, and removals appear here as they ship. Stay up to date on our latest API improvements.

feat: add PUT /v2/schedule_overrides/{id}
feat: add DELETE /v2/schedule_overrides/{id}
feat: add the new optional query request parameter incident in GET /v2/escalations
feat: add the required property description to the response in GET /v2/escalations, POST /v2/escalations and 1 more
feat: add audit log event extension_connector.called.2
feat: add audit log event telemetry_data_source.queried.2
feat: add the optional property escalation_path to the response in GET /v2/escalation_paths, POST /v2/escalation_paths and 2 more
feat: add the new optional request property escalation_path in POST /v2/escalation_paths, PUT /v2/escalation_paths/{id}

feat: add the new escalation_path enum value to the type response property in GET /v2/escalation_paths, POST /v2/escalation_paths and 2 more
feat: add the new escalation_path enum value to the request property type in POST /v2/escalation_paths, PUT /v2/escalation_paths/{id}
feat: add audit log event extension_connector.called.1
feat: add audit log event telemetry_data_source.queried.1
feat: add audit log event telemetry_data_source.requested.1
feat: add audit log event incident_template.set_as_default.1

feat: add the new heartbeats_ping enum value to the name response property in GET /v1/api_keys, POST /v1/api_keys and 3 more
feat: add the new heartbeats_ping enum value to the roles response property in GET /v1/identity
feat: add the new heartbeats_ping enum value to the team_roles response property in GET /v1/identity
feat: add the new heartbeats_ping enum value to the request property role_names in POST /v1/api_keys, PUT /v1/api_keys/{id}
feat: add the new heartbeats_ping enum value to the request property team_role_names in POST /v1/api_keys, PUT /v1/api_keys/{id}
removed: remove POST /v3/alert_sources/{alert_source_id}/attributes/actions/validate
removed: remove the schema AlertSourceAttributeValidatePayloadV3
removed: remove the schema AlertSourcesValidateAttributePayloadV3

feat: add POST /v3/alert_sources/{alert_source_id}/attributes/actions/validate

feat: add the new notion enum value to the provider response property in GET /v1/actions, GET /v1/actions/{id} and 9 more
feat: add the new notion enum value to the request property provider in POST /v2/follow_ups/{id}/actions/connect_external_issue

feat: add audit log event incident_template.created.1
feat: add audit log event incident_template.deleted.1
feat: add audit log event incident_template.updated.1
removed: remove the enum value jira of the request property replica_provider in POST /v2/schedules/{schedule_id}/replicas
removed: remove the jira enum value from the replica_provider response property in GET /v2/schedules/{schedule_id}/replicas, POST /v2/schedules/{schedule_id}/replicas and 1 more

feat: add the new jsm enum value to the replica_provider response property in GET /v2/schedules/{schedule_id}/replicas, POST /v2/schedules/{schedule_id}/replicas and 1 more
feat: add the new jsm enum value to the request property replica_provider in POST /v2/schedules/{schedule_id}/replicas

feat: add POST /v2/alert_sources/actions/validate
feat: add GET /v2/call_sessions
feat: add GET /v2/call_transcript_entries
feat: add the new call_transcripts_viewer enum value to the name response property in GET /v1/api_keys, POST /v1/api_keys and 3 more
feat: add the new call_transcripts_viewer enum value to the roles response property in GET /v1/identity
feat: add the new call_transcripts_viewer enum value to the request property role_names in POST /v1/api_keys, PUT /v1/api_keys/{id}

fix: the attempts request property’s max was set to 10.00 in POST /v2/escalation_paths, PUT /v2/escalation_paths/{id}
fix: the attempts request property’s min was set to 2.00 in POST /v2/escalation_paths, PUT /v2/escalation_paths/{id}
feat: add the optional property retry_config to the response in GET /v2/escalation_paths, POST /v2/escalation_paths and 2 more
feat: add the new optional request property retry_config in POST /v2/escalation_paths, PUT /v2/escalation_paths/{id}

feat: add the new next_on_call enum value to the sync_type response property in GET /v2/schedules/{schedule_id}/sync_rules, POST /v2/schedules/{schedule_id}/sync_rules and 2 more
feat: add the new next_on_call enum value to the request property sync_type in POST /v2/schedules/{schedule_id}/sync_rules, PUT /v2/schedules/{schedule_id}/sync_rules/{id}
feat: add the required property engine_resource_type to the response in GET /v3/catalog_entries, GET /v3/catalog_entries/{id} and 7 more
feat: add the required property status to the response in GET /v2/incidents, POST /v2/incidents and 2 more

feat: add GET /v2/workflow_runs
feat: add GET /v2/workflow_runs/{id}

feat: add the new workflows_viewer enum value to the name response property in GET /v1/api_keys, POST /v1/api_keys and 3 more
feat: add the new workflows_viewer enum value to the roles response property in GET /v1/identity
feat: add the new workflows_viewer enum value to the request property role_names in POST /v1/api_keys, PUT /v1/api_keys/{id}

feat: add the required property permanent_member_user_ids to the response in GET /v2/schedules/{schedule_id}/sync_rules, POST /v2/schedules/{schedule_id}/sync_rules and 2 more
feat: add the new optional request property permanent_member_user_ids in POST /v2/schedules/{schedule_id}/sync_rules, PUT /v2/schedules/{schedule_id}/sync_rules/{id}
removed: remove GET /v1/openapi.json

feat: add the new optional query request parameter include_inactive in GET /v2/users
feat: add the required property is_active to the response in GET /v2/users, GET /v2/users/{id}
feat: add GET /v2/schedule_overrides

feat: add the new optional request property group_alerts_summary in POST /v3/alert_routes, PUT /v3/alert_routes/{id}
feat: add the optional property group_alerts_summary to the response in POST /v3/alert_routes, GET /v3/alert_routes/{id} and 1 more

feat: add audit log event telemetry_data_source.write_access_granted.1
feat: add audit log event telemetry_data_source.write_access_revoked.1

feat: add the new wiz enum value to the source_type response property in GET /v2/alert_sources, POST /v2/alert_sources and 2 more
feat: add the new wiz enum value to the request property source_type in POST /v2/alert_sources

feat: add the required property permalink to the response in GET /v2/schedules, POST /v2/schedules and 2 more
feat: add audit log event secret.reference_added.1
feat: add audit log event secret.reference_removed.1

feat: add audit log event announcement_rule.created.2
feat: add audit log event announcement_rule.updated.2
feat: add GET /v2/secrets
feat: add POST /v2/secrets
feat: add DELETE /v2/secrets/{id}
feat: add GET /v2/secrets/{id}
feat: add PUT /v2/secrets/{id}
feat: add POST /v2/secrets/{id}/actions/rotate
feat: add the new secrets_manage enum value to the name response property in GET /v1/api_keys, POST /v1/api_keys and 3 more
feat: add the new secrets_use enum value to the name response property in GET /v1/api_keys, POST /v1/api_keys and 3 more
feat: add the new secrets_manage enum value to the roles response property in GET /v1/identity
feat: add the new secrets_manage enum value to the team_roles response property in GET /v1/identity
feat: add the new secrets_use enum value to the roles response property in GET /v1/identity
feat: add the new secrets_use enum value to the team_roles response property in GET /v1/identity
feat: add the new secrets_manage enum value to the request property role_names in POST /v1/api_keys, PUT /v1/api_keys/{id}
feat: add the new secrets_manage enum value to the request property team_role_names in POST /v1/api_keys, PUT /v1/api_keys/{id}
feat: add the new secrets_use enum value to the request property role_names in POST /v1/api_keys, PUT /v1/api_keys/{id}
feat: add the new secrets_use enum value to the request property team_role_names in POST /v1/api_keys, PUT /v1/api_keys/{id}

feat: add the new dash0 enum value to the source_type response property in GET /v2/alert_sources, POST /v2/alert_sources and 2 more
feat: add the new dash0 enum value to the request property source_type in POST /v2/alert_sources
feat: add the new optional query request parameter query in POST /v2/alert_events/http/{alert_source_config_id}

feat: add the optional property owning_team_ids to the response in GET /v3/catalog_entries, GET /v3/catalog_entries/{id} and 6 more
feat: add the new optional request property owning_team_ids in POST /v3/catalog_types, PUT /v3/catalog_types/{id}
feat: add audit log event private_incident.access_attempted.2

feat: add the optional property comments to the response in GET /v1/api_keys, POST /v1/api_keys and 3 more
feat: add the new optional request property comments in POST /v1/api_keys, PUT /v1/api_keys/{id}
feat: add audit log event secret.created.1
feat: add audit log event secret.deleted.1
feat: add audit log event secret.rotated.1
feat: add audit log event secret.updated.1
feat: add the new optional request property emoji in POST /v1/incident_attachments
feat: add the new optional request property title in POST /v1/incident_attachments

feat: add the new catalog_editor enum value to the name response property in GET /v1/api_keys, POST /v1/api_keys and 3 more
feat: add the new catalog_editor enum value to the team_roles response property in GET /v1/identity
feat: add the new catalog_editor enum value to the request property team_role_names in POST /v1/api_keys, PUT /v1/api_keys/{id}
feat: add the new optional request property membership_teams in POST /v2/alert_routes, PUT /v2/alert_routes/{id} and 2 more
feat: add the optional property membership_teams to the response in POST /v2/alert_routes, GET /v2/alert_routes/{id} and 4 more
feat: add the new arbitrary_url enum value to the resource_type response property in GET /v1/incident_attachments, POST /v1/incident_attachments
feat: add the new enum value arbitrary_url to the query request parameter resource_type in GET /v1/incident_attachments
feat: add the new arbitrary_url enum value to the request property resource_type in POST /v1/incident_attachments
feat: add audit log event policy_report_schedule.created.1
feat: add audit log event policy_report_schedule.deleted.1
feat: add audit log event policy_report_schedule.updated.1

feat: add audit log event policy.created.2
feat: add audit log event policy.updated.2
feat: add POST /v2/status_page_retrospective_incidents
feat: add the required property private_incident_scope to the response in GET /v2/workflows, POST /v2/workflows and 2 more
feat: add the new optional request property private_incident_scope in POST /v2/workflows, PUT /v2/workflows/{id}
fix: the request property include_private_incidents became optional in POST /v2/workflows, PUT /v2/workflows/{id}
feat: add audit log event announcement_post_template.created.2
feat: add audit log event announcement_post_template.updated.2

feat: add the new private_escalation_workflows_editor enum value to the name response property in GET /v1/api_keys, POST /v1/api_keys and 3 more
feat: add the new private_workflows_editor enum value to the name response property in GET /v1/api_keys, POST /v1/api_keys and 3 more
feat: add the new private_escalation_workflows_editor enum value to the roles response property in GET /v1/identity
feat: add the new private_workflows_editor enum value to the team_roles response property in GET /v1/identity
feat: add the new private_escalation_workflows_editor enum value to the request property role_names in POST /v1/api_keys, PUT /v1/api_keys/{id}
feat: add the new private_workflows_editor enum value to the request property team_role_names in POST /v1/api_keys, PUT /v1/api_keys/{id}
feat: add the new optional query request parameter alert_group_id in GET /v2/alerts
feat: add the new service_now enum value to the source_type response property in GET /v2/alert_sources, POST /v2/alert_sources and 2 more
feat: add the new service_now enum value to the request property source_type in POST /v2/alert_sources

feat: add the new optional query request parameter alert_group_id in GET /v1/alert_notes
feat: add the optional property alert_group_id to the response in GET /v1/alert_notes, POST /v1/alert_notes and 2 more
feat: add the optional property alert_id to the response in GET /v1/alert_notes, POST /v1/alert_notes and 2 more
feat: add the new optional request property alert_group_id in POST /v1/alert_notes
fix: the query request parameter alert_id became optional in GET /v1/alert_notes
fix: the request property alert_id became optional in POST /v1/alert_notes
feat: add the optional property alert_group_ids to the response in GET /v2/alerts, GET /v2/alerts/{id} and 5 more
feat: add audit log event announcement_post_template.created.1
feat: add audit log event announcement_post_template.deleted.1
feat: add audit log event announcement_post_template.set_as_default.1
feat: add audit log event announcement_post_template.updated.1
feat: add the new workflows_editor enum value to the name response property in GET /v1/api_keys, POST /v1/api_keys and 3 more
feat: add the new workflows_editor enum value to the team_roles response property in GET /v1/identity
feat: add the new workflows_editor enum value to the request property team_role_names in POST /v1/api_keys, PUT /v1/api_keys/{id}
feat: add the optional property owning_team_ids to the response in GET /v2/workflows, POST /v2/workflows and 2 more
feat: add the new optional request property owning_team_ids in POST /v2/workflows, PUT /v2/workflows/{id}

feat: add GET /v3/alert_routes
feat: add POST /v3/alert_routes
feat: add DELETE /v3/alert_routes/{id}
feat: add GET /v3/alert_routes/{id}
feat: add PUT /v3/alert_routes/{id}
feat: add the new notification_methods_unredacted_viewer enum value to the name response property in GET /v1/api_keys, POST /v1/api_keys and 3 more
feat: add the new notification_methods_unredacted_viewer enum value to the roles response property in GET /v1/identity
feat: add the new notification_methods_unredacted_viewer enum value to the request property role_names in POST /v1/api_keys, PUT /v1/api_keys/{id}

feat: add the new optional query request parameter attributes in GET /v2/alerts

feat: add the new on_call_viewer enum value to the name response property in GET /v1/api_keys, POST /v1/api_keys and 3 more
feat: add the new on_call_viewer enum value to the roles response property in GET /v1/identity
feat: add the new on_call_viewer enum value to the request property role_names in POST /v1/api_keys, PUT /v1/api_keys/{id}
feat: add POST /v2/follow_ups/{id}/actions/connect_external_issue

feat: add POST /v2/escalations/{id}/actions/cancel

feat: add GET /v2/incident_participants
feat: add the new optional request property form_fields in POST /v2/workflows, PUT /v2/workflows/{id}
feat: add the optional property form_fields to the response in POST /v2/workflows, GET /v2/workflows/{id} and 1 more

feat: add the optional property external_id to the response in GET /v3/teams, GET /v3/teams/{id}
feat: add the optional property owning_team_ids to the response in GET /v1/incident_types, GET /v1/incident_types/{id} and 3 more

feat: add the new cast enum value to the operation_type response property in POST /v2/alert_routes, GET /v2/alert_routes/{id} and 9 more
feat: add the new optional request property cast in POST /v2/alert_routes, PUT /v2/alert_routes/{id} and 4 more
feat: add the new cast enum value to the request property operation_type in POST /v2/alert_routes, PUT /v2/alert_routes/{id} and 4 more
removed: remove the schema AuditLogsPrivateIncidentMembershipRemovedFromChannelV1
removed: remove audit log event private_incident_membership.removed_from_channel.1

feat: add audit log event private_incident_membership.upgraded_to_direct.1
removed: remove the request property version in POST /v2/alert_routes
feat: add GET /v2/incident_participant_workloads

feat: add POST /v1/postmortem_documents/actions/attach
feat: add the new incident_workload_private_viewer enum value to the name response property in GET /v1/api_keys, POST /v1/api_keys and 3 more
feat: add the new incident_workload_private_viewer enum value to the roles response property in GET /v1/identity
feat: add the new incident_workload_private_viewer enum value to the request property role_names in POST /v1/api_keys, PUT /v1/api_keys/{id}
feat: add the new optional query request parameter has_notes in GET /v2/alerts
feat: add audit log event private_incident_membership.removed_from_channel.1

feat: add the new voicemail enum value to the type response property in GET /v2/escalation_paths, POST /v2/escalation_paths and 2 more
feat: add the new voicemail enum value to the request property type in POST /v2/escalation_paths, PUT /v2/escalation_paths/{id}

feat: add POST /v2/actions
feat: add DELETE /v2/actions/{id}
feat: add PUT /v2/actions/{id}
feat: add POST /v2/follow_ups
feat: add DELETE /v2/follow_ups/{id}
feat: add PUT /v2/follow_ups/{id}

feat: add the new incident_workload_viewer enum value to the name response property in GET /v1/api_keys, POST /v1/api_keys and 3 more
feat: add the new incident_workload_viewer enum value to the roles response property in GET /v1/identity
feat: add the new incident_workload_viewer enum value to the request property role_names in POST /v1/api_keys, PUT /v1/api_keys/{id}

feat: add audit log event incident_type.created.2
feat: add audit log event incident_type.updated.2
feat: add GET /v1/alert_notes
feat: add POST /v1/alert_notes
feat: add DELETE /v1/alert_notes/{id}
feat: add GET /v1/alert_notes/{id}
feat: add PUT /v1/alert_notes/{id}

feat: add the optional property rotation_id to the response in GET /v2/schedules/{schedule_id}/sync_rules, POST /v2/schedules/{schedule_id}/sync_rules and 2 more
feat: add the new optional request property rotation_id in POST /v2/schedules/{schedule_id}/sync_rules
feat: add audit log event private_incident_team_membership.granted.1
feat: add audit log event private_incident_team_membership.revoked.1

feat: add POST /v2/schedules/{id}/actions/preview_entries

feat: add webhook event schedule.created_v1
feat: add webhook event schedule.deleted_v1
feat: add webhook event schedule.updated_v1
feat: add audit log event user.logged_in.1
feat: add the optional property fixed_filter to the response in GET /v2/custom_fields, POST /v2/custom_fields and 2 more
feat: add the new optional request property fixed_filter in POST /v2/custom_fields, PUT /v2/custom_fields/{id}

feat: add the new optional query request parameter assignee_team_id in GET /v2/follow_ups
feat: add the optional property assignee_team to the response in GET /v2/follow_ups, GET /v2/follow_ups/{id}
feat: add the new optional request property url in POST /v1/incident_attachments
fix: the request property external_id became optional in POST /v1/incident_attachments

feat: add the new optional header request parameter authorization in POST /v2/alert_events/http/{alert_source_config_id}, GET /v2/heartbeat/{alert_source_config_id}/ping and 1 more

feat: add the new optional request property app_key in PUT /v2/telemetry/data_sources/{id}

feat: add the new optional request property api_url in PUT /v2/telemetry/data_sources/{id}

feat: add the new big_panda enum value to the source_type response property in GET /v2/alert_sources, POST /v2/alert_sources and 2 more
feat: add the new big_panda enum value to the request property source_type in POST /v2/alert_sources
feat: add audit log event on_call_upsell.requested.1

feat: add audit log event private_insights.exported.1
feat: add audit log event private_insights.measure_queried.1
feat: add audit log event private_insights.underlying_data_queried.1
feat: add audit log event hris_time_off_policy.updated.1
feat: add the optional property phone to the response in GET /v2/users/{user_id}/notification_rules

feat: add the new optional request property incident_id in POST /v2/escalations
feat: add the optional property version to the response in PUT /v2/telemetry/data_sources/{id}

feat: add the optional property phone_details to the response in GET /v2/users/{user_id}/notification_methods
feat: add the new whatsapp_message enum value to the method_type response property in GET /v2/users/{user_id}/notification_methods, GET /v2/users/{user_id}/notification_rules

feat: add the new optional request property annotations in POST /v2/schedule_sync_targets, PUT /v2/schedule_sync_targets/{id} and 2 more

feat: add the new act_on_behalf_of_users enum value to the name response property in GET /v1/api_keys, POST /v1/api_keys and 3 more
feat: add the new act_on_behalf_of_users enum value to the roles response property in GET /v1/identity
feat: add the new act_on_behalf_of_users enum value to the request property role_names in POST /v1/api_keys, PUT /v1/api_keys/{id}
feat: add GET /v2/schedule_sync_targets
feat: add POST /v2/schedule_sync_targets
feat: add DELETE /v2/schedule_sync_targets/{id}
feat: add GET /v2/schedule_sync_targets/{id}
feat: add PUT /v2/schedule_sync_targets/{id}
feat: add GET /v2/schedules/{schedule_id}/sync_rules
feat: add POST /v2/schedules/{schedule_id}/sync_rules
feat: add DELETE /v2/schedules/{schedule_id}/sync_rules/{id}
feat: add GET /v2/schedules/{schedule_id}/sync_rules/{id}
feat: add PUT /v2/schedules/{schedule_id}/sync_rules/{id}
fix: the request property interval became required in POST /v2/schedules, PUT /v2/schedules/{id}
fix: the request property interval_type became required in POST /v2/schedules, PUT /v2/schedules/{id}
fix: the response property interval became required in GET /v2/schedules, POST /v2/schedules and 2 more
fix: the response property interval_type became required in GET /v2/schedules, POST /v2/schedules and 2 more

feat: add POST /v2/alerts/{id}/actions/resolve
feat: add audit log event schedule_sync_target.updated.1
feat: add audit log event schedule_sync_rule.updated.1
fix: for the query request parameter entry_window_start, the format was widened from date-time to none in GET /v2/schedule_entries

feat: add webhook event schedule.shift_change_v1
feat: add the optional property selected_rota_id to the response in GET /v2/escalation_paths, POST /v2/escalation_paths and 2 more
feat: add the new optional request property selected_rota_id in POST /v2/escalation_paths, PUT /v2/escalation_paths/{id}
feat: add audit log event schedule_sync_rule.created.1
feat: add audit log event schedule_sync_rule.deleted.1
feat: add webhook event private_escalation.escalation_status_updated_v1
feat: add webhook event public_escalation.escalation_status_updated_v1

feat: add audit log event schedule_sync_target.created.1
feat: add audit log event schedule_sync_target.deleted.1
feat: add webhook event private_escalation.escalation_created_v1
feat: add webhook event public_escalation.escalation_created_v1
feat: add webhook event private_alert.alert_resolved_v1
feat: add webhook event public_alert.alert_resolved_v1

feat: add the new currently_on_call_for_rota enum value to the schedule_mode response property in GET /v2/escalation_paths, POST /v2/escalation_paths and 2 more
feat: add the new next_on_call enum value to the schedule_mode response property in GET /v2/escalation_paths, POST /v2/escalation_paths and 2 more
feat: add the new next_on_call_for_rota enum value to the schedule_mode response property in GET /v2/escalation_paths, POST /v2/escalation_paths and 2 more
feat: add the new currently_on_call_for_rota enum value to the request property schedule_mode in POST /v2/escalation_paths, PUT /v2/escalation_paths/{id}
feat: add the new next_on_call enum value to the request property schedule_mode in POST /v2/escalation_paths, PUT /v2/escalation_paths/{id}
feat: add the new next_on_call_for_rota enum value to the request property schedule_mode in POST /v2/escalation_paths, PUT /v2/escalation_paths/{id}

feat: add GET /v2/users/{user_id}/paging_provider
feat: add POST /v2/users/{user_id}/paging_provider
feat: add the optional property transform_expression to the response in GET /v2/alert_sources, POST /v2/alert_sources and 2 more
feat: add the required property redactions to the response in GET /v2/alert_sources, POST /v2/alert_sources and 2 more
feat: add the new optional request property email_options in POST /v2/alert_sources, PUT /v2/alert_sources/{id}

feat: add the required property type to the response in GET /v1/postmortem_documents, GET /v1/postmortem_documents/{id} and 2 more

feat: add the optional property mirror_window_days to the response in GET /v2/schedules/{schedule_id}/replicas, POST /v2/schedules/{schedule_id}/replicas and 1 more
feat: add the new optional request property mirror_window_days in POST /v2/schedules/{schedule_id}/replicas

feat: add POST /v2/incidents/{id}/actions/import_postmortem_document

feat: add audit log event email_otp_login_setting.updated.1
feat: add audit log event qr_code_mobile_login_setting.updated.1

feat: add GET /v2/heartbeat/{alert_source_config_id}/ping
feat: add POST /v2/heartbeat/{alert_source_config_id}/ping

removed: remove the optional property time_to_ack_interval_condition from the response in GET /v2/escalation_paths, POST /v2/escalation_paths and 2 more
removed: remove the optional property time_to_ack_seconds from the response in GET /v2/escalation_paths, POST /v2/escalation_paths and 2 more
removed: remove the optional property time_to_ack_weekday_interval_config_id from the response in GET /v2/escalation_paths, POST /v2/escalation_paths and 2 more
removed: remove the request property time_to_ack_interval_condition in POST /v2/escalation_paths, PUT /v2/escalation_paths/{id}
removed: remove the request property time_to_ack_seconds in POST /v2/escalation_paths, PUT /v2/escalation_paths/{id}
removed: remove the request property time_to_ack_weekday_interval_config_id in POST /v2/escalation_paths, PUT /v2/escalation_paths/{id}

feat: add the optional property delay_interval_condition to the response in GET /v2/escalation_paths, POST /v2/escalation_paths and 2 more
feat: add the optional property delay_seconds to the response in GET /v2/escalation_paths, POST /v2/escalation_paths and 2 more
feat: add the optional property delay_weekday_interval_config_id to the response in GET /v2/escalation_paths, POST /v2/escalation_paths and 2 more
feat: add the new optional request property delay_interval_condition in POST /v2/escalation_paths, PUT /v2/escalation_paths/{id}
feat: add the new optional request property delay_seconds in POST /v2/escalation_paths, PUT /v2/escalation_paths/{id}
feat: add the new optional request property delay_weekday_interval_config_id in POST /v2/escalation_paths, PUT /v2/escalation_paths/{id}
feat: add the optional property next_shifts to the response in GET /v2/schedules, POST /v2/schedules and 2 more
feat: add the optional property alert_events_url to the response in GET /v2/alert_sources, POST /v2/alert_sources and 2 more
feat: add GET /v2/users/{user_id}/notification_rules

feat: add the required property seats to the response in GET /v2/users, GET /v2/users/{id}

feat: add audit log event follow_up_category.created.1
feat: add audit log event follow_up_category.deleted.1
feat: add audit log event follow_up_category.updated.1
feat: add the new notification_methods_manage enum value to the name response property in GET /v1/api_keys, POST /v1/api_keys and 3 more
feat: add the new notification_methods_manage enum value to the roles response property in GET /v1/identity
feat: add the new notification_methods_manage enum value to the request property role_names in POST /v1/api_keys, PUT /v1/api_keys/{id}
feat: add GET /v2/users/{user_id}/notification_methods

removed: remove POST /v2/heartbeat/{alert_source_config_id}/ping
feat: add the new optional request property disabled in PUT /v2/alert_sources/{id}
feat: add the new salesforce_case enum value to the resource_type response property in GET /v1/incident_attachments, POST /v1/incident_attachments
feat: add the new enum value salesforce_case to the query request parameter resource_type in GET /v1/incident_attachments
feat: add the new salesforce_case enum value to the request property resource_type in POST /v1/incident_attachments

feat: add the optional property last_used_at to the response in GET /v1/api_keys, POST /v1/api_keys and 3 more
feat: add the optional property heartbeat_options to the response in GET /v2/alert_sources, POST /v2/alert_sources and 2 more
feat: add the new optional request property heartbeat_options in POST /v2/alert_sources, PUT /v2/alert_sources/{id}
feat: add the new delay enum value to the type response property in GET /v2/escalation_paths, POST /v2/escalation_paths and 2 more
feat: add the new delayed enum value to the status response property in GET /v2/escalations, POST /v2/escalations and 1 more
feat: add the optional property delay to the response in GET /v2/escalation_paths, POST /v2/escalation_paths and 2 more
feat: add the new optional request property delay in POST /v2/escalation_paths, PUT /v2/escalation_paths/{id}
feat: add the new delay enum value to the request property type in POST /v2/escalation_paths, PUT /v2/escalation_paths/{id}

feat: add POST /v2/heartbeat/{alert_source_config_id}/ping
feat: add GET /v2/schedules/{schedule_id}/replicas
feat: add POST /v2/schedules/{schedule_id}/replicas
feat: add DELETE /v2/schedules/{schedule_id}/replicas/{id}
feat: add GET /v2/schedules/{schedule_id}/replicas/{id}

feat: add the new heartbeat enum value to the source_type response property in GET /v2/alert_sources, POST /v2/alert_sources and 2 more
feat: add the new heartbeat enum value to the request property source_type in POST /v2/alert_sources
fix: the for_seconds request property’s min was set to 0.00 in POST /v2/workflows, PUT /v2/workflows/{id}

feat: add GET /v1/api_keys
feat: add POST /v1/api_keys
feat: add DELETE /v1/api_keys/{id}
feat: add GET /v1/api_keys/{id}
feat: add PUT /v1/api_keys/{id}
feat: add POST /v1/api_keys/{id}/actions/rotate

removed: remove the catalog_editor enum value from the team_roles response property in GET /v1/identity
removed: remove the catalog_viewer enum value from the team_roles response property in GET /v1/identity
removed: remove the global_access enum value from the team_roles response property in GET /v1/identity
removed: remove the incident_creator enum value from the team_roles response property in GET /v1/identity
removed: remove the incident_editor enum value from the team_roles response property in GET /v1/identity
removed: remove the incident_memberships_editor enum value from the team_roles response property in GET /v1/identity
removed: remove the investigation_download enum value from the team_roles response property in GET /v1/identity
removed: remove the manage_settings enum value from the team_roles response property in GET /v1/identity
removed: remove the post_incident_flow_opt_out enum value from the team_roles response property in GET /v1/identity
removed: remove the postmortems_manage enum value from the team_roles response property in GET /v1/identity
removed: remove the private_workflows_editor enum value from the team_roles response property in GET /v1/identity
removed: remove the security_settings_editor enum value from the team_roles response property in GET /v1/identity
removed: remove the status_page_publisher enum value from the team_roles response property in GET /v1/identity
removed: remove the team_memberships_manage enum value from the team_roles response property in GET /v1/identity
removed: remove the viewer enum value from the team_roles response property in GET /v1/identity
removed: remove the workflows_editor enum value from the team_roles response property in GET /v1/identity
feat: add PUT /v2/telemetry/data_sources/{id}
feat: add audit log event api_key.rotated.1

feat: add GET /v3/teams
feat: add GET /v3/teams/{id}
removed: remove the schema APIKeyV2

feat: add the new optional query request parameter expand in GET /v3/catalog_entries/{id}
removed: remove POST /v1/api_keys/api_keys
removed: remove the schema APIKeyV1
removed: remove the schema APIKeysCreatePayloadV1
removed: remove the schema APIKeysCreateResultV1
feat: add POST /v1/api_keys/api_keys

feat: add the new api_keys_manage enum value to the team_roles response property in GET /v1/identity
feat: add the required property team_roles to the response in GET /v1/identity
feat: add the required property teams to the response in GET /v1/identity
feat: add the new api_keys_manage enum value to the roles response property in GET /v1/identity

feat: add GET /v1/maintenance_windows
feat: add POST /v1/maintenance_windows
feat: add DELETE /v1/maintenance_windows/{id}
feat: add GET /v1/maintenance_windows/{id}
feat: add PUT /v1/maintenance_windows/{id}
feat: add the optional property is_team_type to the response in GET /v3/catalog_entries, GET /v3/catalog_entries/{id} and 6 more
feat: add audit log event maintenance_window.created.1
feat: add audit log event maintenance_window.deleted.1
feat: add audit log event maintenance_window.updated.1

feat: add the new optional query request parameter include_maintenance_window in GET /v2/alerts

removed: delete the query request parameter include_maintenance_window in GET /v2/alerts
feat: add the new optional query request parameter include_maintenance_window in GET /v2/alerts

feat: add the optional property repeat_config to the response in GET /v2/escalation_paths, POST /v2/escalation_paths and 2 more
feat: add the new optional request property repeat_config in POST /v2/escalation_paths, PUT /v2/escalation_paths/{id}

feat: add the new pending_repeat enum value to the status response property in GET /v2/escalations, POST /v2/escalations and 1 more
feat: add webhook event private_incident.postmortem_document_status_updated_v1
feat: add webhook event public_incident.postmortem_document_status_updated_v1
feat: add audit log event api_key.updated.1
feat: add audit log event schedule_override.created.2
feat: add audit log event schedule_override.deleted.2
feat: add audit log event schedule_override.updated.2

feat: add GET /v1/postmortem_documents
feat: add GET /v1/postmortem_documents/{id}
feat: add PUT /v1/postmortem_documents/{id}
feat: add GET /v1/postmortem_documents/{id}/content
feat: add the optional property emoji to the response in GET /v2/alert_attributes, POST /v2/alert_attributes and 4 more
feat: add the new optional request property emoji in POST /v2/alert_attributes, PUT /v2/alert_attributes/{id}
feat: add the new optional query request parameter alert_source in GET /v2/alerts

feat: add the new vercel enum value to the source_type response property in GET /v2/alert_sources, POST /v2/alert_sources and 2 more
feat: add the new vercel enum value to the request property source_type in POST /v2/alert_sources

feat: add the optional property auto_resolve_incident_alerts to the response in GET /v2/alert_sources, POST /v2/alert_sources and 2 more
feat: add the new optional request property auto_resolve_incident_alerts in POST /v2/alert_sources, PUT /v2/alert_sources/{id}
feat: add the new postmortems_manage enum value to the roles response property in GET /v1/identity
feat: add the optional property postmortem_document_ids to the response in GET /v2/incidents, POST /v2/incidents and 2 more

feat: add the optional property auto_resolve_timeout_minutes to the response in GET /v2/alert_sources, POST /v2/alert_sources and 2 more
feat: add the new optional request property auto_resolve_timeout_minutes in POST /v2/alert_sources, PUT /v2/alert_sources/{id}

feat: add the new optional query request parameter sort_by in GET /v2/incidents

feat: add the optional property merge_strategy to the response in GET /v2/alert_sources, POST /v2/alert_sources and 2 more
feat: add the new optional request property merge_strategy in POST /v2/alert_sources, PUT /v2/alert_sources/{id}

feat: add the new optional request property message_template in POST /v2/alert_routes, PUT /v2/alert_routes/{id}
feat: add the optional property message_template to the response in POST /v2/alert_routes, GET /v2/alert_routes/{id} and 1 more
feat: add audit log event alert_chat_message_template.created.1
feat: add audit log event alert_chat_message_template.deleted.1
feat: add audit log event alert_chat_message_template.updated.1
feat: add the new optional request property working_intervals in POST /v2/schedules, PUT /v2/schedules/{id}

feat: add audit log event activity_log.scrubbed.1
feat: add audit log event timeline_item.deleted.1

feat: add audit log event alert.scrubbed.1
feat: add audit log event escalation.scrubbed.1
feat: add the new snoozed enum value to the status response property in GET /v2/escalations, POST /v2/escalations and 1 more

feat: add audit log event incident_timestamp_set_by_rule.created.1
feat: add audit log event incident_timestamp_set_by_rule.deleted.1
feat: add audit log event incident_timestamp_set_by_rule.updated.1

feat: add GET /v2/status_page_incidents
feat: add GET /v2/status_page_maintenances

feat: add GET /v2/escalation_paths
feat: add the optional property sub_page to the response in GET /v2/status_page_structures/{status_page_id}

feat: add POST /v2/status_page_incident_updates
feat: add POST /v2/status_page_incidents
feat: add GET /v2/status_page_incidents/{status_page_incident_id}
feat: add PUT /v2/status_page_incidents/{status_page_incident_id}
feat: add POST /v2/status_page_maintenance_updates
feat: add POST /v2/status_page_maintenances
feat: add GET /v2/status_page_maintenances/{status_page_maintenance_id}
feat: add GET /v2/status_page_structures/{status_page_id}
feat: add GET /v2/status_pages

feat: add audit log event on_call_notification_method.created.2
feat: add audit log event on_call_notification_method.destroyed.2

feat: add the new optional request property skip_step_upgrades in PUT /v2/workflows/{id}
feat: add audit log event on_call_notification_method.destroyed.1

feat: add audit log event on_call_notification_method.created.1
feat: add audit log event connector_config.created.1
feat: add audit log event connector_config.token_generated.1
feat: add audit log event connector_config.updated.1
removed: remove POST /v2/status_page_incidents
removed: remove the schema StatusPageIncidentAffectedComponentSlimV2
removed: remove the schema StatusPageIncidentAffectedComponentV2
removed: remove the schema StatusPageIncidentComponentImpactV2
removed: remove the schema StatusPageIncidentUpdateV2
removed: remove the schema StatusPageIncidentV2
removed: remove the schema StatusPagesCreateStatusPageIncidentPayloadV2
removed: remove the schema StatusPagesCreateStatusPageIncidentResultV2

feat: add POST /v2/status_page_incidents
removed: remove GET /v2/status_page_incidents/{status_page_incident_id}
removed: remove PUT /v2/status_page_incidents/{status_page_incident_id}
removed: remove GET /v2/status_pages/{id}
removed: remove the schema StatusPageStructureComponentV2
removed: remove the schema StatusPageStructureGroupV2
removed: remove the schema StatusPageStructureItemV2
removed: remove the schema StatusPageStructureV2
removed: remove the schema StatusPagesShowStatusPageIncidentResultV2
removed: remove the schema StatusPagesShowStatusPageResultV2
removed: remove the schema StatusPagesUpdateStatusPageIncidentPayloadV2
removed: remove the schema StatusPagesUpdateStatusPageIncidentResultV2
feat: add GET /v2/status_pages/{id}
feat: add GET /v2/status_page_incidents/{status_page_incident_id}
feat: add PUT /v2/status_page_incidents/{status_page_incident_id}

feat: add the new status_page_publisher enum value to the roles response property in GET /v1/identity

fix: the defer_time_seconds request property format changed from int64 to int32 in POST /v2/alert_routes, PUT /v2/alert_routes/{id}
fix: the grouping_window_seconds request property format changed from int64 to int32 in POST /v2/alert_routes, PUT /v2/alert_routes/{id}
fix: the defer_time_seconds response’s property format was narrowed from int64 to int32 in POST /v2/alert_routes, GET /v2/alert_routes/{id} and 1 more
fix: the grouping_window_seconds response’s property format was narrowed from int64 to int32 in POST /v2/alert_routes, GET /v2/alert_routes/{id} and 1 more

feat: add the new optional query request parameter idempotency_key in GET /v2/escalations
feat: add the optional property total_record_count to the response in GET /v3/catalog_entries
removed: remove the schema PaginationMetaResultV3

feat: add audit log event alert_priority.created.1
feat: add audit log event alert_priority.deleted.1
feat: add audit log event alert_priority.set_as_default.1
feat: add audit log event alert_priority.updated.1

Getting started

Webhooks

Audit logs

Deprecated endpoints