# Flashduty Docs: English API Reference

> Flashduty 官方文档，涵盖 On-call 告警响应、Monitors 监控、RUM 与 AI SRE 的配置指南、集成方式和 API 参考。

## API Reference

### Developer Guide

- [Quick start](https://docs.flashduty.com/en/openapi/introduction.md): Flashduty Open API quick start guide
- [API catalog](https://docs.flashduty.com/en/openapi/api-catalog.md): Complete list of Flashduty Open API endpoints, organized by product module with links to detailed documentation
- [About pagination](https://docs.flashduty.com/en/openapi/pagination.md): Flashduty Open API pagination mechanism
- [Rate limits](https://docs.flashduty.com/en/openapi/rate-limits.md): Flashduty Open API rate limits and error codes

### On-call

#### Incidents

- [Get war-room default observers](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-read-get-war-room-default-observers.md): Return historical responders suggested as default observers when opening a war room.
- [Add war-room member](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-write-add-war-room-member.md): Add one or more members to the IM war room bound to an incident integration.
- [Initialize post-mortem](https://docs.flashduty.com/en/api-reference/on-call/incidents/postmortem-write-init.md): Create a post-mortem draft from one or more incidents and a template.
- [Update post-mortem basics](https://docs.flashduty.com/en/api-reference/on-call/incidents/postmortem-write-reset-basics.md): Replace the incident facts stored in a post-mortem report.
- [Update post-mortem status](https://docs.flashduty.com/en/api-reference/on-call/incidents/postmortem-write-reset-status.md): Set a post-mortem report to drafting or published.
- [Update post-mortem title](https://docs.flashduty.com/en/api-reference/on-call/incidents/postmortem-write-reset-title.md): Replace the title of a post-mortem report.
- [Update post-mortem follow-ups](https://docs.flashduty.com/en/api-reference/on-call/incidents/postmortem-write-reset-follow-ups.md): Replace the follow-up action items on a post-mortem report.
- [Reset post-mortem content](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-post-mortem-write-reset-content.md): Replace the body of a drafting post-mortem report with Markdown.
- [Create or update post-mortem template](https://docs.flashduty.com/en/api-reference/on-call/incidents/postmortem-write-upsert-template.md): Create a custom post-mortem template or update an existing one.
- [Delete post-mortem template](https://docs.flashduty.com/en/api-reference/on-call/incidents/postmortem-write-delete-template.md): Delete a custom post-mortem template.
- [List post-mortem templates](https://docs.flashduty.com/en/api-reference/on-call/incidents/postmortem-read-list-templates.md): Return built-in and custom post-mortem templates for the account.
- [Get post-mortem template detail](https://docs.flashduty.com/en/api-reference/on-call/incidents/postmortem-read-template-info.md): Return one post-mortem template by ID.

##### Incident info

- [List incidents](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-list.md): Query a paginated list of incidents with filters by channel, severity, status, responder, and time range.
- [Get incident detail](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-info.md): Retrieve detailed information for a single incident including timeline, alerts, responders and custom fields.
- [List incidents by IDs](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-list-by-ids.md): Retrieve multiple incidents by their IDs in a single request.
- [List alerts of incident](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-alert-list.md): List all alerts merged into a specific incident.
- [Get incident timeline](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-feed.md): Retrieve the timeline feed for a specific incident, including state changes, comments and system events.
- [List past incidents](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-past-list.md): List historical incidents related to the current incident for reference during triage.
- [Get ServiceDeskPlus linked incidents](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-service-desk-plus-request-read-list.md): List synchronization mappings between ServiceDeskPlus requests and Flashduty incidents.
- [Update incident fields](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-reset.md): Update one or more editable fields of an incident in a single call, including title, description, impact, root cause, resolution, and severity. At least one field must be provided.
- [Add comment to incident](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-comment.md): Add a text comment to the incident timeline.
- [Update incident custom field](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-field-reset.md): Update a custom field value on an incident.
- [Execute custom action](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-custom-action-do.md): Execute a custom action configured for an incident.

##### Status lifecycle

- [Create incident](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-create.md): Manually create a new incident and assign responders.
- [Acknowledge incident](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-ack.md): Acknowledge an incident to indicate you are actively working on it.
- [Unacknowledge incident](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-unack.md): Remove the acknowledge status from an incident.
- [Resolve incident](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-resolve.md): Mark an incident as resolved.
- [Reopen incident](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-reopen.md): Reopen a previously resolved incident.
- [Snooze incident](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-snooze.md): Temporarily snooze notifications for an incident until a specified time.
- [Wake incident](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-wake.md): Cancel the snooze on an incident and resume notifications.
- [Merge incidents](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-merge.md): Merge one or more incidents into a target incident.
- [Disable incident merge](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-disable-merge.md): Disable automatic merging for a specific incident.
- [Delete an incident](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-remove.md): Permanently delete an incident and all associated data.
- [Assign incident](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-assign.md): Dispatch an incident to a specific escalation level or responder.
- [Add incident responder](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-responder-add.md): Add a responder to an existing incident.

##### War room

- [Get war room detail](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-war-room-detail.md): Retrieve the war room configuration and members for an incident.
- [List war rooms](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-war-room-list.md): List all war rooms associated with an incident.
- [Create war room](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-war-room-create.md): Create a war room channel for collaborative incident response.
- [Delete war room](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-war-room-delete.md): Delete an incident war room.

##### Post-Mortem

- [Get post-mortem](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-post-mortem-info.md): Retrieve a post-mortem report by its `post_mortem_id`. List reports via `/incident/post-mortem/list` first — each row carries the incident it covers — then fetch the full report here by that id.
- [List post-mortems](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-post-mortem-list.md): List post-mortem reports with optional filters.
- [Delete post-mortem](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-post-mortem-delete.md): Delete a post-mortem report.

##### Comment types

- [List comment types](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-comment-type-list.md): Retrieve all comment types of the account, ordered by their display position.
- [Create a comment type](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-comment-type-create.md): Create a comment type that can be attached to incident comments.
- [Update a comment type](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-comment-type-update.md): Update the name and/or color of an existing account comment type.
- [Delete a comment type](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-comment-type-delete.md): Delete a comment type. Comments that used it keep their text but lose the type label.
- [Reorder comment types](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-comment-type-reorder.md): Set the display order of all comment types by passing every type ID in the desired order.

##### Work items

- [List work items](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-work-item-list.md): List incident work items (actions and post-mortem follow-ups) with cursor pagination.
- [Create a work item](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-work-item-create.md): Create an action on an active incident or a follow-up on one of its post-mortems.
- [Update a work item](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-work-item-update.md): Partially update a work item's title, description, status, or priority.
- [Delete a work item](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-work-item-delete.md): Soft-delete a work item.
- [Complete a work item](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-work-item-complete.md): Mark a work item as completed by setting a client-defined target status.
- [Convert a work item to a follow-up](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-work-item-convert.md): Convert an incident action item into a post-mortem follow-up in place.
- [Reset work item assignees](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-work-item-reset-assignees.md): Replace a work item's entire assignee set.
- [Bind work items to a post-mortem](https://docs.flashduty.com/en/api-reference/on-call/incidents/incident-work-item-bind-post-mortem.md): Bulk-bind an incident's converted-but-unbound follow-ups to a post-mortem.

#### Channels

- [Get channel detail](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-info.md): Retrieve detailed information for a specific channel.
- [List channels](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-list.md): List channels accessible to the current user with optional filters.
- [Batch get channels](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-infos.md): Retrieve multiple channels by their IDs.
- [Create channel](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-create.md): Create a new channel for incident management.
- [Update channel](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-update.md): Update an existing channel's configuration and settings.
- [Delete channel](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-delete.md): Delete a channel. Only a `disabled` channel can be deleted; all of its escalation, silence, drop and inhibit rules are deleted with it. The call fails when an integration route still references the channel.
- [Enable channel](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-enable.md): Enable a channel to resume incident routing. Only a `disabled` channel can be enabled.
- [Disable channel](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-disable.md): Disable a channel to stop incident routing without deleting it; a disabled channel discards incoming events. Only an `enabled` channel can be disabled.

##### Escalation rules

- [Get escalation rule detail](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-escalate-rule-info.md): Retrieve detailed information for a specific escalation rule.
- [List escalation rules](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-escalate-rule-list.md): List all escalation rules for a channel.
- [Create escalation rule](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-escalate-rule-create.md): Create an escalation rule defining who gets notified and when during an incident.
- [Update escalation rule](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-escalate-rule-update.md): Update an existing escalation rule configuration.
- [Delete escalation rule](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-escalate-rule-delete.md): Delete an escalation rule. Only a `disabled` rule can be deleted.
- [Enable escalation rule](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-escalate-rule-enable.md): Enable a disabled escalation rule. Only a `disabled` rule can be enabled.
- [Disable escalation rule](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-escalate-rule-disable.md): Disable an escalation rule without deleting it. Only an `enabled` rule can be disabled.

##### Silence rules

- [List silence rules](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-silence-rule-list.md): List all silence rules configured for a channel.
- [Create silence rule](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-silence-rule-create.md): Create a silence rule to suppress notifications matching specified conditions.
- [Update silence rule](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-silence-rule-update.md): Update an existing silence rule configuration.
- [Delete silence rule](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-silence-rule-delete.md): Delete a silence rule. Only a `disabled` rule can be deleted.
- [Enable silence rule](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-silence-rule-enable.md): Enable a disabled silence rule. Only a `disabled` rule can be enabled.
- [Disable silence rule](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-silence-rule-disable.md): Disable a silence rule without deleting it. Only an `enabled` rule can be disabled.

##### Inhibit rules

- [List inhibit rules](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-inhibit-rule-list.md): List all inhibit rules configured for a channel.
- [Create inhibit rule](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-inhibit-rule-create.md): Create an inhibit rule to suppress lower-priority alerts when higher-priority ones are firing.
- [Update inhibit rule](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-inhibit-rule-update.md): Update an existing inhibit rule configuration.
- [Delete inhibit rule](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-inhibit-rule-delete.md): Delete an inhibit rule. Only a `disabled` rule can be deleted.
- [Enable inhibit rule](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-inhibit-rule-enable.md): Enable a disabled inhibit rule. Only a `disabled` rule can be enabled.
- [Disable inhibit rule](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-inhibit-rule-disable.md): Disable an inhibit rule without deleting it. Only an `enabled` rule can be disabled.

##### Drop rules

- [List drop rules](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-unsubscribe-rule-list.md): List drop rules for a channel.
- [Create drop rule](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-unsubscribe-rule-create.md): Create a drop rule to filter out unwanted alerts before they become incidents.
- [Update drop rule](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-unsubscribe-rule-update.md): Update an existing drop rule configuration.
- [Delete drop rule](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-unsubscribe-rule-delete.md): Delete a drop rule. Only a `disabled` rule can be deleted.
- [Enable drop rule](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-unsubscribe-rule-enable.md): Enable a disabled drop rule. Only a `disabled` rule can be enabled.
- [Disable drop rule](https://docs.flashduty.com/en/api-reference/on-call/channels/channel-unsubscribe-rule-disable.md): Disable a drop rule without deleting it. Only an `enabled` rule can be disabled.

#### Alerts

- [List alerts](https://docs.flashduty.com/en/api-reference/on-call/alerts/alert-read-list.md): Return a cursor-paginated list of alerts matching the given filters.
- [Get alert detail](https://docs.flashduty.com/en/api-reference/on-call/alerts/alert-read-info.md): Return the full details of a single alert by its ID, including its associated incident and event count.
- [List alerts by IDs](https://docs.flashduty.com/en/api-reference/on-call/alerts/alert-read-list-by-ids.md): Return the details of multiple alerts by their IDs in a single request. Note: this endpoint does not paginate — `total` and `has_next_page` are always `0`/`false` and `search_after_ctx` is never set.
- [List events for an alert](https://docs.flashduty.com/en/api-reference/on-call/alerts/alert-read-event-list.md): Return raw events for an alert with cursor or page-number pagination.
- [List alert activity feed](https://docs.flashduty.com/en/api-reference/on-call/alerts/alert-read-feed.md): Return the activity feed (comments, state changes, merges, silence events) for a single alert, with page-based pagination.
- [Merge alerts into an incident](https://docs.flashduty.com/en/api-reference/on-call/alerts/alert-write-merge.md): Associate one or more alerts with an existing incident. If a source alert previously belonged to a different incident and that incident becomes empty after the merge, it will be automatically closed.
- [Get alert pipeline](https://docs.flashduty.com/en/api-reference/on-call/alerts/alert-read-pipeline-info.md): Return the alert processing pipeline configured for a specific integration.
- [List alert pipelines](https://docs.flashduty.com/en/api-reference/on-call/alerts/alert-read-pipeline-list.md): Return the alert processing pipelines configured for multiple integrations.
- [Create or update alert pipeline](https://docs.flashduty.com/en/api-reference/on-call/alerts/alert-write-pipeline-upsert.md): Set the alert processing pipeline for an integration. Replaces the existing configuration entirely.
- [List raw alert events](https://docs.flashduty.com/en/api-reference/on-call/alerts/alert-event-read-list.md): Return a cursor-paginated list of raw alert events across all alerts, with filtering by integration, channel, time range, and severity.

#### Integrations

- [List webhook delivery history](https://docs.flashduty.com/en/api-reference/on-call/integrations/webhook-history-list.md): List the delivery history for outbound webhook notifications.
- [Get webhook delivery detail](https://docs.flashduty.com/en/api-reference/on-call/integrations/webhook-history-detail.md): Retrieve the detailed payload and response for a specific webhook delivery attempt.
- [Attempt IM person linking](https://docs.flashduty.com/en/api-reference/on-call/integrations/datasource-im-person-try-link.md): Try to automatically link unbound members to their IM accounts for one integration.
- [List integration types](https://docs.flashduty.com/en/api-reference/on-call/integrations/integration-api-read-type-list.md): List the integration types the account can configure.
- [List integrations](https://docs.flashduty.com/en/api-reference/on-call/integrations/integration-api-read-list.md): List public integrations with their stored settings, decrypted keys, and edit permissions.
- [Get integration detail](https://docs.flashduty.com/en/api-reference/on-call/integrations/integration-api-read-info.md): Get a public integration with its stored settings and decrypted integration key.
- [Create integration](https://docs.flashduty.com/en/api-reference/on-call/integrations/integration-api-write-create.md): Create a public integration for a supported alert, change, IM, or webhook type.
- [Update integration](https://docs.flashduty.com/en/api-reference/on-call/integrations/integration-api-write-update.md): Update an integration's name, description, team, or settings.
- [Delete integration](https://docs.flashduty.com/en/api-reference/on-call/integrations/integration-api-write-delete.md): Delete an integration that nothing else references.
- [Enable integration](https://docs.flashduty.com/en/api-reference/on-call/integrations/integration-api-write-enable.md): Re-enable a disabled integration so it accepts events again.
- [Disable integration](https://docs.flashduty.com/en/api-reference/on-call/integrations/integration-api-write-disable.md): Disable an integration without deleting its configuration.
- [Rotate integration key](https://docs.flashduty.com/en/api-reference/on-call/integrations/integration-api-write-rotate-key.md): Issue a new integration key and invalidate the previous one.

#### IM integrations

- [List war-room-enabled IM integrations](https://docs.flashduty.com/en/api-reference/on-call/integrations/im-war-room-enabled-list.md): List IM integrations that have the war-room feature enabled for the account.

#### Routing rules

- [Get routing rule detail](https://docs.flashduty.com/en/api-reference/on-call/channels/route-info.md): Retrieve the routing rule configuration for a specific integration. Returns null when the integration has no routing rule configured.
- [List routing rules](https://docs.flashduty.com/en/api-reference/on-call/channels/route-list.md): Return routing rules for the specified integrations. Integrations without a configured rule are omitted from the response.
- [Upsert routing rule](https://docs.flashduty.com/en/api-reference/on-call/channels/route-upsert.md): Create or update routing rules for an integration to direct alerts to specific channels. At least one of `cases` or `default` must be provided.

#### Schedules

- [Create schedule](https://docs.flashduty.com/en/api-reference/on-call/schedules/schedule-create.md): Create a new on-call schedule (escalation rule schedule).
- [Update schedule](https://docs.flashduty.com/en/api-reference/on-call/schedules/schedule-update.md): Update an existing on-call schedule. Provide schedule_id to identify the schedule.
- [Preview schedule](https://docs.flashduty.com/en/api-reference/on-call/schedules/schedule-preview.md): Preview the coverage generated by a schedule configuration without persisting it. The request accepts the same body as create/update plus a required start/end window (max 45 days).
- [Delete schedules](https://docs.flashduty.com/en/api-reference/on-call/schedules/schedule-delete.md): Delete one or more on-call schedules by ID.
- [Get schedule info](https://docs.flashduty.com/en/api-reference/on-call/schedules/schedule-info.md): Return details of an on-call schedule including the computed schedule layers for the requested time window (max 45 days).
- [List schedules](https://docs.flashduty.com/en/api-reference/on-call/schedules/schedule-list.md): Return a paginated list of on-call schedules. When both start and end are provided (max 45 days apart), computed layer schedules are included.
- [List my schedules](https://docs.flashduty.com/en/api-reference/on-call/schedules/schedule-self.md): Return on-call schedules where the current user is assigned.
- [Get member on-call status](https://docs.flashduty.com/en/api-reference/on-call/schedules/schedule-by-person.md): Get a member's current and next on-call shifts and every enabled schedule they participate in.
- [Batch get schedules](https://docs.flashduty.com/en/api-reference/on-call/schedules/schedule-infos.md): Return details of multiple on-call schedules by their IDs.

#### Licenses

- [List On-call licenses](https://docs.flashduty.com/en/api-reference/on-call/licenses/oncall-license-read-license-list.md): List people with active fixed or temporary On-call licenses in the current account.

#### Calendars

- [Create calendar](https://docs.flashduty.com/en/api-reference/on-call/calendars/calendar-create.md): Create a personal service calendar. Each account is limited to 5 calendars unless the Flashcat-Break-Cal-Limit header is set.
- [Update calendar](https://docs.flashduty.com/en/api-reference/on-call/calendars/calendar-update.md): Update a personal service calendar. Only non-null fields are updated.
- [Delete calendar](https://docs.flashduty.com/en/api-reference/on-call/calendars/calendar-delete.md): Delete a personal service calendar. The call fails when referenced by escalation or silence rules.
- [Get calendar info](https://docs.flashduty.com/en/api-reference/on-call/calendars/calendar-info.md): Return details of a service calendar.
- [List calendars](https://docs.flashduty.com/en/api-reference/on-call/calendars/calendar-list.md): Return the list of service calendars visible to the current account.

##### Calendar events

- [Upsert calendar event](https://docs.flashduty.com/en/api-reference/on-call/calendars/cal-event-upsert.md): Create or update a calendar event (holiday or workday override). Omit event_id to create a new event.
- [Delete calendar event](https://docs.flashduty.com/en/api-reference/on-call/calendars/cal-event-delete.md): Delete a calendar event by calendar ID and event ID.
- [List calendar events](https://docs.flashduty.com/en/api-reference/on-call/calendars/cal-event-list.md): Return events for a personal calendar within a year/month/day scope. When month and day are both omitted the whole year is returned.

#### Notification templates

- [Get template detail](https://docs.flashduty.com/en/api-reference/on-call/notification-templates/template-read-info.md): Return a single notification template by ID.
- [List templates](https://docs.flashduty.com/en/api-reference/on-call/notification-templates/template-read-list.md): Return a paginated list of notification templates.
- [Create a template](https://docs.flashduty.com/en/api-reference/on-call/notification-templates/template-write-create.md): Create a new notification template.
- [Update a template](https://docs.flashduty.com/en/api-reference/on-call/notification-templates/template-write-update.md): Update an existing template. Only the fields present in the request are written: a channel you omit keeps its current content, and an explicit empty string clears it.
- [Delete a template](https://docs.flashduty.com/en/api-reference/on-call/notification-templates/template-write-delete.md): Soft-delete a template by ID.
- [Preview template](https://docs.flashduty.com/en/api-reference/on-call/notification-templates/template-read-preview.md): Render a notification template against incident data or mock data and return the output.

#### Alert enrichment

- [Get enrichment rules](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/enrichment-read-info.md): Return the enrichment rule set configured for a specific integration.
- [List enrichment rules](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/enrichment-read-list.md): Return the enrichment rule sets for a list of integration IDs.
- [Upsert enrichment rules](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/enrichment-write-upsert.md): Create or fully replace the enrichment rule set for an integration. The entire `rules` array is replaced atomically.
- [Get field detail](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/field-read-info.md): Return the configuration of a single incident custom field by ID.
- [List fields](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/field-read-list.md): Return all incident custom fields configured for the account.
- [Create field](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/field-write-create.md): Create a new incident custom field on the account.
- [Update field](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/field-write-update.md): Update mutable attributes of an existing incident custom field.
- [Delete field](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/field-write-delete.md): Delete an incident custom field and asynchronously strip it from existing incidents.

##### Mapping schemas

- [List mapping schemas](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/mapping-schema-read-list.md): Return all mapping schemas for the account, sorted by creation time ascending.
- [Get mapping schema detail](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/mapping-schema-read-info.md): Return detail of a single mapping schema by its ID.
- [Create mapping schema](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/mapping-schema-write-create.md): Create a new mapping schema defining source lookup labels and the result labels to populate. Requires a Pro plan.
- [Update mapping schema](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/mapping-schema-write-update.md): Update the name, description, or owning team of a mapping schema. Source and result labels cannot be changed after creation.
- [Delete mapping schema](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/mapping-schema-write-delete.md): Delete a mapping schema and all its associated data. Deletion is blocked if the schema is referenced by any enrichment rule or webhook.

##### Mapping data

- [List mapping data](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/mapping-data-read-list.md): Return paginated mapping data rows for a schema, with optional exact-match filtering on source label values.
- [Upsert mapping data rows](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/mapping-data-write-upsert.md): Insert or update up to 1000 data rows in a mapping schema. Each row must contain all source and result labels.
- [Delete mapping data rows](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/mapping-data-write-delete.md): Delete up to 100 mapping data rows by their keys.
- [Truncate mapping data](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/mapping-data-write-truncate.md): Delete all data rows in a mapping schema.
- [Upload mapping data via CSV](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/mapping-data-write-upload.md): Upload a CSV file to bulk-load mapping data. By default the existing data is truncated before loading the new rows.
- [Download mapping data as CSV](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/mapping-data-read-download.md): Export all data rows of a mapping schema as a CSV file download.

##### Mapping API sources

- [List mapping APIs](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/mapping-api-read-list.md): Return all mapping APIs configured for the account.
- [Get mapping API detail](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/mapping-api-read-info.md): Return detail of a single mapping API by its ID.
- [Create mapping API](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/mapping-api-write-create.md): Create a new external HTTP API endpoint used to enrich alerts via HTTP lookup.
- [Update mapping API](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/mapping-api-write-update.md): Update configuration of an existing mapping API.
- [Delete mapping API](https://docs.flashduty.com/en/api-reference/on-call/alert-enrichment/mapping-api-write-delete.md): Delete a mapping API. Deletion is blocked if the API is referenced by any enrichment rule.

#### Analytics

- [Get top-K alerts grouped by check or resource](https://docs.flashduty.com/en/api-reference/on-call/analytics/insight-topk-alerts-by-label.md): Return the top-K alert groups aggregated either by `check` or by `resource` label over the specified time range.
- [Get account-level insight](https://docs.flashduty.com/en/api-reference/on-call/analytics/insight-by-account.md): Return aggregated incident insight metrics for the entire account.
- [List insight incidents](https://docs.flashduty.com/en/api-reference/on-call/analytics/insight-incident-list.md): Return a paged list of incidents with per-incident handling metrics used by the analytics dashboard.
- [Export insight incidents](https://docs.flashduty.com/en/api-reference/on-call/analytics/insight-incident-export.md): Export the filtered incident analytics list as a CSV file. The response is a CSV stream delivered with `Content-Disposition: attachment` — it is not a JSON envelope. CSV headers and formatted values use the request locale, falling back to the member locale and then the account locale. `time_zone` de…
- [Get channel insight](https://docs.flashduty.com/en/api-reference/on-call/analytics/insight-by-channel.md): Return insight metrics aggregated by channel.
- [Export channel insight](https://docs.flashduty.com/en/api-reference/on-call/analytics/insight-channel-export.md): Export channel insight metrics as a CSV file — one row per channel (and per time/hour bucket when `aggregate_unit`/`split_hours` is used). The response is a CSV stream delivered with `Content-Disposition: attachment` — it is not a JSON envelope. `time_zone` defaults to UTC. Rows without a valid chan…
- [Get team insight](https://docs.flashduty.com/en/api-reference/on-call/analytics/insight-by-team.md): Return insight metrics aggregated by team.
- [Export team insight](https://docs.flashduty.com/en/api-reference/on-call/analytics/insight-team-export.md): Export team insight metrics as a CSV file — one row per team (and per time/hour bucket when `aggregate_unit`/`split_hours` is used). The response is a CSV stream delivered with `Content-Disposition: attachment` — it is not a JSON envelope. `time_zone` defaults to UTC. Rows without a valid team ID ar…
- [Get responder insight](https://docs.flashduty.com/en/api-reference/on-call/analytics/insight-by-responder.md): Return insight metrics aggregated by responder.
- [Export responder insight](https://docs.flashduty.com/en/api-reference/on-call/analytics/insight-responder-export.md): Export responder insight metrics as a CSV file — one row per responder (and per time/hour bucket when `aggregate_unit`/`split_hours` is used). The response is a CSV stream delivered with `Content-Disposition: attachment` — it is not a JSON envelope. `time_zone` defaults to UTC. Rows without a valid…

#### Status pages

- [List status pages](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-read-page-list.md): List all status pages owned by the account, including their components and sections.
- [List active status page events](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-change-active-list.md): List in-progress (non-terminal) events of a given type for a status page.
- [Get status page detail](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-info.md): Retrieve detailed configuration for a specific status page.
- [Create status page](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-create.md): Create a new status page.
- [Update status page](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-update.md): Update an existing status page configuration.
- [Delete status page](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-delete.md): Delete a status page.
- [Upsert status page component](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-component-upsert.md): Create or update a service component on a status page.
- [Delete status page component](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-component-delete.md): Delete a service component from a status page.
- [Upsert status page section](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-section-upsert.md): Create or update a section on a status page.
- [Delete status page section](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-section-delete.md): Delete a section from a status page.
- [Upsert status page template](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-template-upsert.md): Create or update an event template for a status page.
- [Delete status page template](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-template-delete.md): Delete an event template from a status page.
- [List status page templates](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-template-list.md): List all event templates for a status page.
- [Create status page draft](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-draft-create.md): Store a status page event draft so a human can review and publish it from the console.

##### Changes

- [Get status page event detail](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-change-info.md): Retrieve details of a specific status page event (incident or maintenance).
- [List status page events](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-change-list.md): List status page events for console management. Unlike the public display endpoints, the response includes hidden components.
- [Create status page event](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-change-create.md): Create a new incident or maintenance event on a status page.
- [Update status page event](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-change-update.md): Update an existing status page event.
- [Delete status page event](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-change-delete.md): Delete a status page event.
- [Create event timeline entry](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-change-timeline-create.md): Add a timeline update to a status page event.
- [Update event timeline entry](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-change-timeline-update.md): Update a timeline entry for a status page event.
- [Delete event timeline entry](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-change-timeline-delete.md): Delete a timeline entry from a status page event.

##### Subscribers

- [List status page subscribers](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-subscriber-list.md): List subscribers who have signed up for status page notifications.
- [Import subscribers](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-subscriber-import.md): Bulk import subscribers for a status page. The account must be allowlisted for subscriber import; otherwise the call is rejected with an access-denied error.
- [Export subscribers](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-subscriber-export.md): Export subscribers list for a status page as a CSV attachment. The response is a `text/csv` file with columns: Method, Recipient, Components, Subscribe All, Locale.

##### Migration

- [Migrate status page structure](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-migrate-structure.md): Start a migration job that imports the structure and historical events of an Atlassian Statuspage into a new Flashduty status page.
- [Migrate email subscribers](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-migrate-email-subscribers.md): Start a migration job that imports email subscribers from an Atlassian Statuspage into an existing Flashduty status page.
- [Get migration status](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-migration-status.md): Get the current status and progress of a status page migration job.
- [Cancel status page migration](https://docs.flashduty.com/en/api-reference/on-call/status-pages/status-page-migration-cancel.md): Cancel an in-progress status page migration job. Only jobs currently in the `running` state can be cancelled.

#### Changes

- [List changes](https://docs.flashduty.com/en/api-reference/on-call/changes/change-read-list.md): Query change records within a time window, with filtering, search, and pagination.

### Monitors

#### Alert rules

- [List alert rules](https://docs.flashduty.com/en/api-reference/monitors/alert-rules/monit-rule-read-list.md): Return the basic information of all alert rules in a folder. For full rule details, call `POST /monit/rule/v2/info`.
- [Get alert rule detail (V2)](https://docs.flashduty.com/en/api-reference/monitors/alert-rules/monit-rule-read-info-v2.md): Return the full V2 configuration of an alert rule by ID, including lifecycle v2 recovery and ending modes.
- [Create alert rule (V2)](https://docs.flashduty.com/en/api-reference/monitors/alert-rules/monit-rule-write-create-v2.md): Create a new V2 alert rule. Returns the created rule with its assigned ID.
- [Update alert rule (V2)](https://docs.flashduty.com/en/api-reference/monitors/alert-rules/monit-rule-write-update-v2.md): Replace an alert rule's V2 configuration in full by ID. Returns the updated rule.
- [Delete alert rule](https://docs.flashduty.com/en/api-reference/monitors/alert-rules/monit-rule-write-delete.md): Delete a single alert rule by its ID.
- [Batch delete alert rules](https://docs.flashduty.com/en/api-reference/monitors/alert-rules/monit-rule-write-delete-batch.md): Delete multiple alert rules in a single request.
- [Batch update rule fields](https://docs.flashduty.com/en/api-reference/monitors/alert-rules/monit-rule-write-fields-update.md): Update specific fields across multiple alert rules at once. Only the fields listed in `fields` are applied.
- [Move alert rules to folder](https://docs.flashduty.com/en/api-reference/monitors/alert-rules/monit-rule-write-move.md): Move one or more alert rules to a different folder.
- [List rule change history](https://docs.flashduty.com/en/api-reference/monitors/alert-rules/monit-rule-read-audits.md): Return the change history (audit records) for an alert rule.
- [Get rule audit snapshot](https://docs.flashduty.com/en/api-reference/monitors/alert-rules/monit-rule-read-audit-detail.md): Return the audit record (including the `content` field, a JSON string of the rule snapshot at that point in time).
- [Get rule counter time series](https://docs.flashduty.com/en/api-reference/monitors/alert-rules/monit-rule-read-counter-total.md): Return the stored time series of the total rule count across the account — one sample per `clock` timestamp.
- [Get rule counts by channel](https://docs.flashduty.com/en/api-reference/monitors/alert-rules/monit-rule-read-counter-channel.md): Return an object mapping channel name to the number of rules routing alerts to that channel. If a channel name cannot be resolved, the channel ID (as a string) is used as the key.

#### Data sources

- [List datasources](https://docs.flashduty.com/en/api-reference/monitors/data-sources/monit-datasource-read-list.md): Return all data sources for the current account. Optionally filter by `type_ident`. Supports diagnostic types redis_node, redis_sentinel, mongodb_mongod, mongodb_mongos and kafka; enabled and alerting_enabled are independent.
- [Get datasource detail](https://docs.flashduty.com/en/api-reference/monitors/data-sources/monit-datasource-read-info.md): Retrieve full details of a single data source by its ID, including the `payload` configuration with its configured connection and authentication settings; treat the response as sensitive and avoid logging or forwarding it. Supports diagnostic types redis_node, redis_sentinel, mongodb_mongod, mongodb…
- [Create datasource](https://docs.flashduty.com/en/api-reference/monitors/data-sources/monit-datasource-write-create.md): Create a new monitoring data source. The `payload` must include the type-specific configuration block. Supports diagnostic types redis_node, redis_sentinel, mongodb_mongod, mongodb_mongos and kafka; enabled and alerting_enabled are independent.
- [Update datasource](https://docs.flashduty.com/en/api-reference/monitors/data-sources/monit-datasource-write-update.md): Update an existing data source. Supply `id` plus the fields to change. Supports diagnostic types redis_node, redis_sentinel, mongodb_mongod, mongodb_mongos and kafka; enabled and alerting_enabled are independent.
- [Delete datasource](https://docs.flashduty.com/en/api-reference/monitors/data-sources/monit-datasource-write-delete.md): Delete a data source by ID. Alert rules referencing this datasource are not blocked: the datasource is removed from their monitoring scope and their open alerts on it are closed automatically.
- [Invoke datasource tool](https://docs.flashduty.com/en/api-reference/monitors/data-sources/monit-datasource-tools-invoke.md): Execute one deterministic diagnostic or query tool against a configured datasource.
- [List SLS projects](https://docs.flashduty.com/en/api-reference/monitors/data-sources/monit-datasource-read-sls-projects.md): List Alibaba Cloud SLS (Simple Log Service) projects available in the specified SLS datasource.
- [List SLS logstores](https://docs.flashduty.com/en/api-reference/monitors/data-sources/monit-datasource-read-sls-logstores.md): List logstores within an SLS project for the specified SLS datasource.
- [List Prometheus label values](https://docs.flashduty.com/en/api-reference/monitors/data-sources/monit-prometheus-read-label-values.md): Read label values from a Prometheus-compatible data source through the Monitors proxy.

#### Diagnostics

- [Query structured data](https://docs.flashduty.com/en/api-reference/monitors/diagnostics/monit-read-query-data.md): Run a synchronous ad-hoc query against a configured data source and return a stable `query_result.v1` result whose natural shape is frames, records, or samples. This public API requires monit-edge v0.65.0 or later.
- [Run Explore query](https://docs.flashduty.com/en/api-reference/monitors/diagnostics/monit-read-query-explore.md): Run an Explore query against a configured data source and return frames, samples, or logs.

#### Dashboards

- [List dashboards](https://docs.flashduty.com/en/api-reference/monitors/dashboards/monit-dashboard-read-list.md): List the dashboards in one folder.
- [Search dashboards](https://docs.flashduty.com/en/api-reference/monitors/dashboards/monit-dashboard-read-search.md): Search dashboards across every readable folder.
- [Get dashboard detail](https://docs.flashduty.com/en/api-reference/monitors/dashboards/monit-dashboard-read-get.md): Fetch one dashboard with its full definition.
- [Get dashboard outline](https://docs.flashduty.com/en/api-reference/monitors/dashboards/monit-dashboard-read-outline.md): Get a dashboard's structure without queries or definitions.
- [Create dashboard](https://docs.flashduty.com/en/api-reference/monitors/dashboards/monit-dashboard-write-create.md): Create a dashboard from a full definition.
- [Update dashboard](https://docs.flashduty.com/en/api-reference/monitors/dashboards/monit-dashboard-write-update.md): Replace a dashboard definition with compare-and-swap on the revision counter.
- [Move dashboard](https://docs.flashduty.com/en/api-reference/monitors/dashboards/monit-dashboard-write-move.md): Move a dashboard to another folder without changing its definition.
- [Delete dashboard](https://docs.flashduty.com/en/api-reference/monitors/dashboards/monit-dashboard-write-delete.md): Move a dashboard to the trash.
- [Restore dashboard](https://docs.flashduty.com/en/api-reference/monitors/dashboards/monit-dashboard-write-restore.md): Bring a trashed dashboard back, optionally into a different folder.
- [List trashed dashboards](https://docs.flashduty.com/en/api-reference/monitors/dashboards/monit-dashboard-trash-read-list.md): List deleted dashboards still inside the 30-day retention window.
- [List dashboard revisions](https://docs.flashduty.com/en/api-reference/monitors/dashboards/monit-dashboard-revision-read-list.md): List a dashboard's revision history, newest first.
- [Get dashboard revision](https://docs.flashduty.com/en/api-reference/monitors/dashboards/monit-dashboard-revision-read-get.md): Fetch one historical revision with its full definition.
- [Resolve dashboard variables](https://docs.flashduty.com/en/api-reference/monitors/dashboards/monit-dashboard-variable-read-resolve.md): Resolve every variable of a stored dashboard for a time range.
- [Preview draft variables](https://docs.flashduty.com/en/api-reference/monitors/dashboards/monit-dashboard-variable-read-preview.md): Resolve a draft variable set that is not stored in any dashboard.
- [Resolve panel queries](https://docs.flashduty.com/en/api-reference/monitors/dashboards/monit-dashboard-query-read-resolve.md): Bind panel queries to datasources and substitute variables without executing them.
- [Run dashboard panel](https://docs.flashduty.com/en/api-reference/monitors/dashboards/monit-dashboard-panel-read-run.md): Execute one panel of a stored dashboard and return the datasource results.
- [Preview draft panel](https://docs.flashduty.com/en/api-reference/monitors/dashboards/monit-dashboard-panel-read-preview.md): Execute a draft panel inline without saving a dashboard revision.

#### Rule folders

- [List monitor folders](https://docs.flashduty.com/en/api-reference/monitors/rule-folders/monit-folder-read-list.md): List every monitor folder the caller can read.

### RUM

#### Applications

- [List applications](https://docs.flashduty.com/en/api-reference/rum/applications/rum-application-read-list.md): Return a paginated list of RUM applications accessible to the current user.
- [Get application detail](https://docs.flashduty.com/en/api-reference/rum/applications/rum-application-read-info.md): Retrieve full details of a single RUM application by `application_id`.
- [Batch get applications](https://docs.flashduty.com/en/api-reference/rum/applications/rum-application-read-infos.md): Retrieve details for multiple RUM applications by their IDs in one request.
- [Create application](https://docs.flashduty.com/en/api-reference/rum/applications/rum-application-write-create.md): Create a new RUM application. Returns the generated `application_id` and `client_token`.
- [Update application](https://docs.flashduty.com/en/api-reference/rum/applications/rum-application-write-update.md): Update an existing RUM application. All fields except `application_id` are optional — only provided fields are updated.
- [Delete application](https://docs.flashduty.com/en/api-reference/rum/applications/rum-application-write-delete.md): Delete a RUM application by `application_id`.
- [Test application webhook](https://docs.flashduty.com/en/api-reference/rum/applications/rum-application-webhook-test.md): Send a sample RUM alert event to verify an application's webhook URL.
- [Get remote config detail](https://docs.flashduty.com/en/api-reference/rum/applications/rum-application-remote-config-read-get.md): Retrieve the live remote configuration of a RUM application and the version it is stored under.
- [Update remote config](https://docs.flashduty.com/en/api-reference/rum/applications/rum-application-remote-config-write-update.md): Publish a complete new remote configuration version for a RUM application.
- [Preview remote config](https://docs.flashduty.com/en/api-reference/rum/applications/rum-application-remote-config-read-preview.md): Evaluate a draft remote configuration against a client context without publishing it.
- [List remote config history](https://docs.flashduty.com/en/api-reference/rum/applications/rum-application-remote-config-read-history-list.md): List published remote configuration versions of a RUM application.
- [Revert remote config](https://docs.flashduty.com/en/api-reference/rum/applications/rum-application-remote-config-write-history-revert.md): Republish an earlier remote configuration version's content as a new version.

#### Data query

- [Query RUM data](https://docs.flashduty.com/en/api-reference/rum/data-query/rum-read-data-query.md): Run one or more SQL-style RUM data queries over a bounded time range.

#### Issues

- [List issues](https://docs.flashduty.com/en/api-reference/rum/issues/rum-issue-read-list.md): Return a paginated list of RUM error tracking issues matching the given filters.
- [Export issues as CSV](https://docs.flashduty.com/en/api-reference/rum/issues/rum-issue-read-export.md): Export the filtered RUM error tracking issues as a CSV file. The response is a `text/csv` stream delivered with `Content-Disposition: attachment` — it is not a JSON envelope; non-console callers can read the `X-Export-Total` and `X-Export-Truncated` response headers.
- [Get issue detail](https://docs.flashduty.com/en/api-reference/rum/issues/rum-issue-read-info.md): Retrieve full details of a single issue by `issue_id`.
- [Update issue](https://docs.flashduty.com/en/api-reference/rum/issues/rum-issue-write-update.md): Update the status or suspected cause of an issue.

#### Session replay

- [Get session replay metadata](https://docs.flashduty.com/en/api-reference/rum/session-replay/rum-session-replay-read-metadata.md): Return the application, device, session bounds, and views recorded for a replayable session.
- [List session replay segments](https://docs.flashduty.com/en/api-reference/rum/session-replay/rum-session-replay-read-segments.md): Page through the recorded replay segments of a session, as presigned URLs or a raw stream.

#### Facets

- [Count facet value distribution](https://docs.flashduty.com/en/api-reference/rum/facets/rum-read-facet-count.md): Return the top N values for a facet field within a time range, sorted by occurrence count descending.
- [List RUM fields](https://docs.flashduty.com/en/api-reference/rum/facets/rum-read-field-list.md): Return RUM field definitions, optionally filtered by scope and facet status.

#### Sourcemaps

- [List sourcemaps](https://docs.flashduty.com/en/api-reference/rum/sourcemaps/sourcemap-read-list.md): Return a paginated list of uploaded sourcemap files filtered by platform type, service, and version.
- [Enrich a stack trace](https://docs.flashduty.com/en/api-reference/rum/sourcemaps/sourcemap-read-stack-enrich.md): Symbolicate or deobfuscate a browser, Android, iOS, Mini Program, or HarmonyOS stack trace.

#### Error ingestion rules

- [List error ingestion rules](https://docs.flashduty.com/en/api-reference/rum/error-ingestion-rules/rum-error-ingestion-rules-list.md): Return every error ingestion rule configured for a RUM application.
- [Create an error ingestion rule](https://docs.flashduty.com/en/api-reference/rum/error-ingestion-rules/rum-error-ingestion-rules-create.md): Create a new error ingestion rule that filters which errors are stored.
- [Update an error ingestion rule](https://docs.flashduty.com/en/api-reference/rum/error-ingestion-rules/rum-error-ingestion-rules-update.md): Update the name, description, or filters of an error ingestion rule.
- [Delete an error ingestion rule](https://docs.flashduty.com/en/api-reference/rum/error-ingestion-rules/rum-error-ingestion-rules-delete.md): Delete an error ingestion rule from a RUM application.
- [Enable an error ingestion rule](https://docs.flashduty.com/en/api-reference/rum/error-ingestion-rules/rum-error-ingestion-rules-enable.md): Re-enable a previously disabled error ingestion rule.
- [Disable an error ingestion rule](https://docs.flashduty.com/en/api-reference/rum/error-ingestion-rules/rum-error-ingestion-rules-disable.md): Disable an error ingestion rule without deleting it.
- [List error ingestion rule history](https://docs.flashduty.com/en/api-reference/rum/error-ingestion-rules/rum-error-ingestion-rules-history-list.md): Return paginated snapshots of an application's error ingestion rule history.
- [Revert error ingestion rules to a history version](https://docs.flashduty.com/en/api-reference/rum/error-ingestion-rules/rum-error-ingestion-rules-history-revert.md): Restore an application's entire rule set to a prior history version.

#### Issue preset severity rules

- [List preset severity rules](https://docs.flashduty.com/en/api-reference/rum/issue-preset-severity-rules/rum-issue-preset-severity-rules-list.md): Return all preset severity rules configured for a RUM application.
- [Create preset severity rule](https://docs.flashduty.com/en/api-reference/rum/issue-preset-severity-rules/rum-issue-preset-severity-rules-create.md): Create a new preset severity rule for a RUM application.
- [Update preset severity rule](https://docs.flashduty.com/en/api-reference/rum/issue-preset-severity-rules/rum-issue-preset-severity-rules-update.md): Update the name, description, filters, or severity of a preset severity rule.
- [Delete preset severity rule](https://docs.flashduty.com/en/api-reference/rum/issue-preset-severity-rules/rum-issue-preset-severity-rules-delete.md): Delete a preset severity rule.
- [Enable preset severity rule](https://docs.flashduty.com/en/api-reference/rum/issue-preset-severity-rules/rum-issue-preset-severity-rules-enable.md): Enable a preset severity rule.
- [Disable preset severity rule](https://docs.flashduty.com/en/api-reference/rum/issue-preset-severity-rules/rum-issue-preset-severity-rules-disable.md): Disable a preset severity rule.
- [Reorder preset severity rule](https://docs.flashduty.com/en/api-reference/rum/issue-preset-severity-rules/rum-issue-preset-severity-rules-reorder.md): Move one preset severity rule to another rule's position in evaluation order.
- [List preset severity rule history](https://docs.flashduty.com/en/api-reference/rum/issue-preset-severity-rules/rum-issue-preset-severity-rules-history-list.md): Return the change history of preset severity rules for a RUM application.
- [Revert preset severity rules to a history snapshot](https://docs.flashduty.com/en/api-reference/rum/issue-preset-severity-rules/rum-issue-preset-severity-rules-history-revert.md): Roll back preset severity rules to the state captured in a specific history snapshot.

#### Resources

- [Get RUM resource info](https://docs.flashduty.com/en/api-reference/rum/resources/rum-resource-read-info.md): Return the account's RUM resource record and its current session usage.

### AI SRE

#### Sessions

- [List sessions](https://docs.flashduty.com/en/api-reference/ai-sre/sessions/session-read-list.md): List agent sessions visible to the caller, filtered by app, surface, archive status, and team.
- [Get session detail](https://docs.flashduty.com/en/api-reference/ai-sre/sessions/session-read-info.md): Fetch one session plus a backward-paged window of its most recent events.
- [Export session transcript](https://docs.flashduty.com/en/api-reference/ai-sre/sessions/session-read-export.md): Stream a session's full event transcript as newline-delimited JSON.
- [Delete session](https://docs.flashduty.com/en/api-reference/ai-sre/sessions/session-write-delete.md): Delete a session by ID.

#### Automations

- [Create Automation rule](https://docs.flashduty.com/en/api-reference/ai-sre/automations/automation-rule-write-create.md): Create an Automation rule with schedule, HTTP POST, and On-call incident triggers.
- [List Automation rules](https://docs.flashduty.com/en/api-reference/ai-sre/automations/automation-rule-read-list.md): List Automation rules visible to the caller.
- [List Automation templates](https://docs.flashduty.com/en/api-reference/ai-sre/automations/automation-template-read-list.md): List preset Automation templates for the requested locale.
- [List Automation runs](https://docs.flashduty.com/en/api-reference/ai-sre/automations/automation-run-read-list.md): List run history for a rule the caller can manage.
- [Get Automation rule](https://docs.flashduty.com/en/api-reference/ai-sre/automations/automation-rule-read-get.md): Get one Automation rule by ID.
- [Update Automation rule](https://docs.flashduty.com/en/api-reference/ai-sre/automations/automation-rule-write-update.md): Update mutable Automation rule fields, including HTTP POST and On-call incident trigger settings.
- [Delete Automation rule](https://docs.flashduty.com/en/api-reference/ai-sre/automations/automation-rule-write-delete.md): Delete an Automation rule.
- [Run Automation rule](https://docs.flashduty.com/en/api-reference/ai-sre/automations/automation-rule-write-run.md): Manually run an Automation rule immediately, outside its schedule.

#### Skills

- [List skills](https://docs.flashduty.com/en/api-reference/ai-sre/skills/skill-read-list.md): List AI SRE skills visible to the caller across account and team scopes, with pagination.
- [Get skill detail](https://docs.flashduty.com/en/api-reference/ai-sre/skills/skill-read-get.md): Get one skill including its full SKILL.md content.
- [Update skill](https://docs.flashduty.com/en/api-reference/ai-sre/skills/skill-write-update.md): Update a skill's descriptions or reassign its team scope.
- [Delete skill](https://docs.flashduty.com/en/api-reference/ai-sre/skills/skill-write-delete.md): Delete a skill by ID.
- [Upload skill](https://docs.flashduty.com/en/api-reference/ai-sre/skills/skill-write-upload.md): Upload a skill archive (.skill/.zip/.tar.gz/.tgz) to create or replace a skill.
- [Enable skill](https://docs.flashduty.com/en/api-reference/ai-sre/skills/skill-read-enable.md): Enable a disabled skill so the agent can load it.
- [Disable skill](https://docs.flashduty.com/en/api-reference/ai-sre/skills/skill-write-disable.md): Disable an enabled skill so the agent stops loading it.

#### MCP servers

- [List MCP servers](https://docs.flashduty.com/en/api-reference/ai-sre/mcp-servers/mcp-read-server-list.md): List MCP servers visible to the caller across account and team scopes, with pagination.
- [Create MCP server](https://docs.flashduty.com/en/api-reference/ai-sre/mcp-servers/mcp-write-server-create.md): Register a new MCP server (connector) on the account.
- [Get MCP server detail](https://docs.flashduty.com/en/api-reference/ai-sre/mcp-servers/mcp-read-server-get.md): Get one MCP server as a pure database read — no live probe is performed.
- [Update MCP server](https://docs.flashduty.com/en/api-reference/ai-sre/mcp-servers/mcp-write-server-update.md): Update an MCP server's configuration. Omit a field to leave it unchanged.
- [Delete MCP server](https://docs.flashduty.com/en/api-reference/ai-sre/mcp-servers/mcp-write-server-delete.md): Delete an MCP server by ID.
- [Enable MCP server](https://docs.flashduty.com/en/api-reference/ai-sre/mcp-servers/mcp-write-server-enable.md): Enable a disabled MCP server.
- [Disable MCP server](https://docs.flashduty.com/en/api-reference/ai-sre/mcp-servers/mcp-write-server-disable.md): Disable an enabled MCP server.

#### A2A agents

- [Create A2A agent](https://docs.flashduty.com/en/api-reference/ai-sre/a2a-agents/remote-agent-write-create.md): Register a new A2A remote agent from its agent-card URL.
- [List A2A agents](https://docs.flashduty.com/en/api-reference/ai-sre/a2a-agents/remote-agent-read-list.md): List A2A agents visible to the caller across account and team scopes, with pagination.
- [Get A2A agent detail](https://docs.flashduty.com/en/api-reference/ai-sre/a2a-agents/remote-agent-read-get.md): Get one A2A agent by ID.
- [Update A2A agent](https://docs.flashduty.com/en/api-reference/ai-sre/a2a-agents/remote-agent-write-update.md): Apply a partial update to an A2A agent. Omit a field to leave it unchanged.
- [Enable A2A agent](https://docs.flashduty.com/en/api-reference/ai-sre/a2a-agents/remote-agent-write-enable.md): Enable a disabled A2A agent.
- [Disable A2A agent](https://docs.flashduty.com/en/api-reference/ai-sre/a2a-agents/remote-agent-write-disable.md): Disable an enabled A2A agent.
- [Delete A2A agent](https://docs.flashduty.com/en/api-reference/ai-sre/a2a-agents/remote-agent-write-delete.md): Soft-delete an A2A agent by ID.

#### Artifacts

- [List artifacts](https://docs.flashduty.com/en/api-reference/ai-sre/artifacts/artifact-read-list.md): List published artifacts visible to the caller, with pagination and title search.
- [Get artifact detail](https://docs.flashduty.com/en/api-reference/ai-sre/artifacts/artifact-read-get.md): Get a single published artifact by ID.
- [Get file publish state](https://docs.flashduty.com/en/api-reference/ai-sre/artifacts/artifact-read-get-file-state.md): Check which presented files already have a live published artifact.
- [Create signed file URLs](https://docs.flashduty.com/en/api-reference/ai-sre/artifacts/artifact-read-sign.md): Create short-lived signed URLs to download or preview a presented file.
- [Download or preview a file](https://docs.flashduty.com/en/api-reference/ai-sre/artifacts/artifact-read-stream.md): Download or preview a file's bytes using a signed token.
- [Publish file as artifact](https://docs.flashduty.com/en/api-reference/ai-sre/artifacts/artifact-write-publish.md): Publish a session-produced file to the artifact gallery.
- [Update artifact](https://docs.flashduty.com/en/api-reference/ai-sre/artifacts/artifact-write-update.md): Rename an artifact or transfer it between personal and team scope.
- [Remove artifact from gallery](https://docs.flashduty.com/en/api-reference/ai-sre/artifacts/artifact-write-delete.md): Detach an artifact from the gallery; the source file stays with its session.
- [Enable public sharing](https://docs.flashduty.com/en/api-reference/ai-sre/artifacts/artifact-write-share-enable.md): Turn on anonymous public sharing for an artifact and return its public link.
- [Update shared snapshot](https://docs.flashduty.com/en/api-reference/ai-sre/artifacts/artifact-write-share-sync.md): Refresh the public snapshot of a shared artifact with its latest content.
- [Revoke public sharing](https://docs.flashduty.com/en/api-reference/ai-sre/artifacts/artifact-write-share-revoke.md): Turn off public sharing; the link stops resolving immediately.

#### Knowledge

- [List knowledge](https://docs.flashduty.com/en/api-reference/ai-sre/knowledge/knowledge-pack-read-list.md): List the knowledge visible to the caller across account and team scopes.
- [Get account knowledge](https://docs.flashduty.com/en/api-reference/ai-sre/knowledge/knowledge-pack-read-get.md): Return the metadata and file list of the account-scope knowledge.
- [Ensure knowledge](https://docs.flashduty.com/en/api-reference/ai-sre/knowledge/knowledge-pack-write-ensure.md): Idempotently create the knowledge at the given scope, or return the existing one.
- [Update knowledge](https://docs.flashduty.com/en/api-reference/ai-sre/knowledge/knowledge-pack-write-update.md): Move knowledge to a different account or team scope.
- [Delete knowledge](https://docs.flashduty.com/en/api-reference/ai-sre/knowledge/knowledge-pack-write-delete.md): Delete knowledge and all of its files.
- [List knowledge files](https://docs.flashduty.com/en/api-reference/ai-sre/knowledge/knowledge-file-read-list.md): List knowledge files with metadata such as size and checksum.
- [Get knowledge file](https://docs.flashduty.com/en/api-reference/ai-sre/knowledge/knowledge-file-read-get.md): Return a knowledge file's metadata and its base64-encoded content.
- [Upload knowledge file](https://docs.flashduty.com/en/api-reference/ai-sre/knowledge/knowledge-file-write-put.md): Create or overwrite a knowledge file with base64-encoded content.
- [Delete knowledge file](https://docs.flashduty.com/en/api-reference/ai-sre/knowledge/knowledge-file-write-delete.md): Delete a knowledge file by its relative path.

### Platform

#### Members

- [Get current member info](https://docs.flashduty.com/en/api-reference/platform/members/member-info.md): Return the profile of the member the credential belongs to. Requires a member-scoped credential — calls authenticated as the account principal (e.g. an account-level app key) are rejected with a 400.
- [List members](https://docs.flashduty.com/en/api-reference/platform/members/member-list.md): Return a paginated list of organization members.
- [Delete member](https://docs.flashduty.com/en/api-reference/platform/members/member-delete.md): Remove a member from the organization by ID, email, phone, or name.
- [Invite members](https://docs.flashduty.com/en/api-reference/platform/members/member-invite.md): Batch invite new members to the organization by email or phone.
- [Grant role to member](https://docs.flashduty.com/en/api-reference/platform/members/member-grant-role.md): Add role assignments to a member. Role IDs that do not exist are silently ignored; if none resolve, the call is a no-op success.
- [Revoke role from member](https://docs.flashduty.com/en/api-reference/platform/members/member-revoke-role.md): Remove role assignments from a member. Role IDs that do not exist are silently ignored; if none resolve, the call is a no-op success.
- [Update member roles](https://docs.flashduty.com/en/api-reference/platform/members/member-update-role.md): Replace all role assignments for a member at once. Role IDs that do not exist are silently dropped; an empty `role_ids` resets the member to the built-in Viewer role (ID 8).
- [Reset member info](https://docs.flashduty.com/en/api-reference/platform/members/member-reset-info.md): Identify a member and reset the specified profile fields.
- [Notify members](https://docs.flashduty.com/en/api-reference/platform/members/member-notify.md): Send an email to account members on behalf of the caller, with content the caller supplies. Only callable with a credential minted for an AI SRE session; any other credential is rejected with `AccessDenied`. Delivery is asynchronous — `accepted` means the email was queued, not that it was delivered.
- [Batch get persons](https://docs.flashduty.com/en/api-reference/platform/members/person-infos.md): Return profile information for a batch of person IDs (members or accounts).

#### Teams

- [Get team detail](https://docs.flashduty.com/en/api-reference/platform/teams/team-read-info.md): Return a single team by ID, name, or external reference ID.
- [Batch get teams](https://docs.flashduty.com/en/api-reference/platform/teams/team-read-infos.md): Return basic info for multiple teams by their IDs in a single request.
- [List teams](https://docs.flashduty.com/en/api-reference/platform/teams/team-read-list.md): Return a paginated list of teams in the current account.
- [Create or update a team](https://docs.flashduty.com/en/api-reference/platform/teams/team-write-upsert.md): Create a new team or update an existing one. Pass `team_id` to update.
- [Delete a team](https://docs.flashduty.com/en/api-reference/platform/teams/team-write-delete.md): Permanently delete a team by ID, name, or external reference ID.

#### Roles & permissions

- [Get role detail](https://docs.flashduty.com/en/api-reference/platform/roles-permissions/role-read-info.md): Return the detail of a single role by its ID.
- [List roles](https://docs.flashduty.com/en/api-reference/platform/roles-permissions/role-read-list.md): Return all custom and built-in roles for the current account.
- [Create or update a role](https://docs.flashduty.com/en/api-reference/platform/roles-permissions/role-write-upsert.md): Create a new custom role or update an existing one. Pass `role_id` to update.
- [Enable a role](https://docs.flashduty.com/en/api-reference/platform/roles-permissions/role-write-enable.md): Re-enable a previously disabled custom role.
- [Disable a role](https://docs.flashduty.com/en/api-reference/platform/roles-permissions/role-write-disable.md): Disable a custom role to prevent it from granting permissions.
- [Delete a role](https://docs.flashduty.com/en/api-reference/platform/roles-permissions/role-write-delete.md): Delete a custom role. While members still hold the role, the call fails with `ReferenceExist` unless `is_force` is true.
- [List permissions](https://docs.flashduty.com/en/api-reference/platform/roles-permissions/role-read-list-permission.md): Return all available permissions, optionally filtered to those granted to specific roles.
- [List permission factors](https://docs.flashduty.com/en/api-reference/platform/roles-permissions/role-read-list-permission-factor.md): Return all permission factors (API, button, menu, URL, visit) granted to the calling member, optionally filtered by type. Requires a member-scoped credential — calls authenticated as the account principal (e.g. an account-level app key) are rejected with a 400, because the account principal implicit…
- [Grant role to members](https://docs.flashduty.com/en/api-reference/platform/roles-permissions/role-write-grant-role.md): Assign a role to one or more members, giving them its permissions.
- [Revoke role from members](https://docs.flashduty.com/en/api-reference/platform/roles-permissions/role-write-revoke-role.md): Remove a role from one or more members, revoking the permissions it granted.

#### Audit logs

- [Search audit logs](https://docs.flashduty.com/en/api-reference/platform/audit-logs/audit-read-search.md): Return a cursor-paginated list of audit log entries within a time range.
- [List auditable operation types](https://docs.flashduty.com/en/api-reference/platform/audit-logs/audit-read-operation-list.md): Return all operation names that are recorded in the audit log, for use as `operations` filter values.

#### Account

- [Get account detail](https://docs.flashduty.com/en/api-reference/platform/account/account-read-info.md): Return the current account's profile and settings.

## OpenAPI Specs

- [on-call.openapi.en](/api-reference/on-call.openapi.en.json)
- [monitors.openapi.en](/api-reference/monitors.openapi.en.json)
- [rum.openapi.en](/api-reference/rum.openapi.en.json)
- [safari.openapi.en](/api-reference/safari.openapi.en.json)
- [platform.openapi.en](/api-reference/platform.openapi.en.json)
