API Catalog - Flashduty Docs

Flashduty Open API provides 339 endpoints covering five major modules: On-call, Monitors, RUM, AI SRE, and Platform. All endpoints use unified authentication and request specifications. See Quick Start for details.

All endpoint URLs use https://api.flashcat.cloud as the base, authenticated via APP Key through query string.

On-call (193 endpoints)

Incidents

Method	Endpoint	Description
POST	`/incident/list`	List incidents
POST	`/incident/info`	Get incident detail
POST	`/incident/list-by-ids`	List incidents by IDs
POST	`/incident/alert/list`	List alerts of incident
POST	`/incident/feed`	Get incident timeline
POST	`/incident/past/list`	List past incidents
POST	`/incident/create`	Create incident
POST	`/incident/ack`	Acknowledge incident
POST	`/incident/unack`	Unacknowledge incident
POST	`/incident/resolve`	Resolve incident
POST	`/incident/reopen`	Reopen incident
POST	`/incident/snooze`	Snooze incident
POST	`/incident/wake`	Wake incident
POST	`/incident/merge`	Merge incidents
POST	`/incident/disable-merge`	Disable incident merge
POST	`/incident/reset`	Update incident fields
POST	`/incident/remove`	Delete an incident
POST	`/incident/comment`	Add comment to incident
POST	`/incident/assign`	Assign incident
POST	`/incident/responder/add`	Add incident responder
POST	`/incident/field/reset`	Update incident custom field
POST	`/incident/custom-action/do`	Execute custom action
POST	`/incident/war-room/detail`	Get war room detail
POST	`/incident/war-room/list`	List war rooms
POST	`/incident/war-room/create`	Create war room
POST	`/incident/war-room/delete`	Delete war room
GET	`/incident/post-mortem/info`	Get post-mortem
POST	`/incident/post-mortem/list`	List post-mortems
POST	`/incident/post-mortem/delete`	Delete post-mortem
POST	`/incident/war-room/default-observers`	Get war-room default observers
POST	`/incident/war-room/add-member`	Add war-room member
POST	`/incident/post-mortem/init`	Initialize post-mortem
POST	`/incident/post-mortem/basics/reset`	Update post-mortem basics
POST	`/incident/post-mortem/status/reset`	Update post-mortem status
POST	`/incident/post-mortem/title/reset`	Update post-mortem title
POST	`/incident/post-mortem/follow-ups/reset`	Update post-mortem follow-ups
POST	`/incident/post-mortem/content/reset`	Reset post-mortem content
POST	`/incident/post-mortem/template/upsert`	Create or update post-mortem template
POST	`/incident/post-mortem/template/delete`	Delete post-mortem template
POST	`/incident/post-mortem/template/list`	List post-mortem templates
GET	`/incident/post-mortem/template/info`	Get post-mortem template detail
POST	`/incident/sdp/request/list`	Get ServiceDeskPlus linked incidents
POST	`/incident/comment-type/list`	List comment types
POST	`/incident/comment-type/create`	Create a comment type
POST	`/incident/comment-type/update`	Update a comment type
POST	`/incident/comment-type/delete`	Delete a comment type
POST	`/incident/comment-type/reorder`	Reorder comment types
POST	`/incident/work-item/list`	List work items
POST	`/incident/work-item/create`	Create a work item
POST	`/incident/work-item/update`	Update a work item
POST	`/incident/work-item/delete`	Delete a work item
POST	`/incident/work-item/complete`	Complete a work item
POST	`/incident/work-item/convert`	Convert a work item to a follow-up
POST	`/incident/work-item/assignees/reset`	Reset work item assignees
POST	`/incident/work-item/post-mortem/bind`	Bind work items to a post-mortem

Channels

Method	Endpoint	Description
POST	`/channel/info`	Get channel detail
POST	`/channel/list`	List channels
POST	`/channel/infos`	Batch get channels
POST	`/channel/create`	Create channel
POST	`/channel/update`	Update channel
POST	`/channel/delete`	Delete channel
POST	`/channel/enable`	Enable channel
POST	`/channel/disable`	Disable channel
POST	`/channel/silence/rule/list`	List silence rules
POST	`/channel/silence/rule/create`	Create silence rule
POST	`/channel/silence/rule/update`	Update silence rule
POST	`/channel/silence/rule/delete`	Delete silence rule
POST	`/channel/silence/rule/enable`	Enable silence rule
POST	`/channel/silence/rule/disable`	Disable silence rule
POST	`/channel/inhibit/rule/list`	List inhibit rules
POST	`/channel/inhibit/rule/create`	Create inhibit rule
POST	`/channel/inhibit/rule/update`	Update inhibit rule
POST	`/channel/inhibit/rule/delete`	Delete inhibit rule
POST	`/channel/inhibit/rule/enable`	Enable inhibit rule
POST	`/channel/inhibit/rule/disable`	Disable inhibit rule
POST	`/channel/unsubscribe/rule/list`	List drop rules
POST	`/channel/unsubscribe/rule/create`	Create drop rule
POST	`/channel/unsubscribe/rule/update`	Update drop rule
POST	`/channel/unsubscribe/rule/delete`	Delete drop rule
POST	`/channel/unsubscribe/rule/enable`	Enable drop rule
POST	`/channel/unsubscribe/rule/disable`	Disable drop rule
POST	`/channel/escalate/rule/info`	Get escalation rule detail
POST	`/channel/escalate/rule/list`	List escalation rules
POST	`/channel/escalate/rule/create`	Create escalation rule
POST	`/channel/escalate/rule/update`	Update escalation rule
POST	`/channel/escalate/rule/delete`	Delete escalation rule
POST	`/channel/escalate/rule/enable`	Enable escalation rule
POST	`/channel/escalate/rule/disable`	Disable escalation rule
POST	`/route/info`	Get routing rule detail
POST	`/route/list`	List routing rules
POST	`/route/upsert`	Upsert routing rule

Alerts

Method	Endpoint	Description
POST	`/alert/list`	List alerts
POST	`/alert/info`	Get alert detail
POST	`/alert/list-by-ids`	List alerts by IDs
POST	`/alert/event/list`	List events for an alert
POST	`/alert/feed`	List alert activity feed
POST	`/alert/merge`	Merge alerts into an incident
POST	`/alert/pipeline/info`	Get alert pipeline
POST	`/alert/pipeline/list`	List alert pipelines
POST	`/alert/pipeline/upsert`	Create or update alert pipeline
POST	`/alert-event/list`	List raw alert events

Integrations

Method	Endpoint	Description
POST	`/webhook/history/list`	List webhook delivery history
POST	`/webhook/history/detail`	Get webhook delivery detail
POST	`/datasource/im/person/try-link`	Attempt IM person linking

Schedules

Method	Endpoint	Description
POST	`/schedule/create`	Create schedule
POST	`/schedule/update`	Update schedule
POST	`/schedule/preview`	Preview schedule
POST	`/schedule/delete`	Delete schedules
POST	`/schedule/info`	Get schedule info
POST	`/schedule/list`	List schedules
POST	`/schedule/self`	List my schedules
POST	`/schedule/by-person`	Get member on-call status
POST	`/schedule/infos`	Batch get schedules

Licenses

Method	Endpoint	Description
POST	`/oncall/license/list`	List On-call licenses

Calendars

Method	Endpoint	Description
POST	`/calendar/create`	Create calendar
POST	`/calendar/update`	Update calendar
POST	`/calendar/delete`	Delete calendar
POST	`/calendar/info`	Get calendar info
POST	`/calendar/list`	List calendars
POST	`/calendar/event/upsert`	Upsert calendar event
POST	`/calendar/event/delete`	Delete calendar event
POST	`/calendar/event/list`	List calendar events

Notification templates

Method	Endpoint	Description
POST	`/template/info`	Get template detail
POST	`/template/list`	List templates
POST	`/template/create`	Create a template
POST	`/template/update`	Update a template
POST	`/template/delete`	Delete a template
POST	`/template/preview`	Preview template

Alert enrichment

Method	Endpoint	Description
POST	`/enrichment/info`	Get enrichment rules
POST	`/enrichment/list`	List enrichment rules
POST	`/enrichment/upsert`	Upsert enrichment rules
POST	`/enrichment/mapping/schema/list`	List mapping schemas
POST	`/enrichment/mapping/schema/info`	Get mapping schema detail
POST	`/enrichment/mapping/schema/create`	Create mapping schema
POST	`/enrichment/mapping/schema/update`	Update mapping schema
POST	`/enrichment/mapping/schema/delete`	Delete mapping schema
POST	`/enrichment/mapping/data/list`	List mapping data
POST	`/enrichment/mapping/data/upsert`	Upsert mapping data rows
POST	`/enrichment/mapping/data/delete`	Delete mapping data rows
POST	`/enrichment/mapping/data/truncate`	Truncate mapping data
POST	`/enrichment/mapping/data/upload`	Upload mapping data via CSV
POST	`/enrichment/mapping/data/download`	Download mapping data as CSV
POST	`/enrichment/mapping/api/list`	List mapping APIs
POST	`/enrichment/mapping/api/info`	Get mapping API detail
POST	`/enrichment/mapping/api/create`	Create mapping API
POST	`/enrichment/mapping/api/update`	Update mapping API
POST	`/enrichment/mapping/api/delete`	Delete mapping API
POST	`/field/info`	Get field detail
POST	`/field/list`	List fields
POST	`/field/create`	Create field
POST	`/field/update`	Update field
POST	`/field/delete`	Delete field

Analytics

Method	Endpoint	Description
POST	`/insight/alert/topk-by-label`	Get top-K alerts grouped by check or resource
POST	`/insight/account`	Get account-level insight
POST	`/insight/incident/list`	List insight incidents
POST	`/insight/incident/export`	Export insight incidents
POST	`/insight/channel`	Get channel insight
POST	`/insight/channel/export`	Export channel insight
POST	`/insight/team`	Get team insight
POST	`/insight/team/export`	Export team insight
POST	`/insight/responder`	Get responder insight
POST	`/insight/responder/export`	Export responder insight

Status pages

Method	Endpoint	Description
GET	`/status-page/change/info`	Get status page event detail
GET	`/status-page/change/list`	List status page events
GET	`/status-page/change/active/list`	List active status page events
POST	`/status-page/change/create`	Create status page event
POST	`/status-page/change/update`	Update status page event
POST	`/status-page/change/delete`	Delete status page event
POST	`/status-page/change/timeline/create`	Create event timeline entry
POST	`/status-page/change/timeline/update`	Update event timeline entry
POST	`/status-page/change/timeline/delete`	Delete event timeline entry
GET	`/status-page/subscriber/list`	List status page subscribers
POST	`/status-page/subscriber/import`	Import subscribers
POST	`/status-page/subscriber/export`	Export subscribers
POST	`/status-page/migrate-structure`	Migrate status page structure
POST	`/status-page/migrate-email-subscribers`	Migrate email subscribers
GET	`/status-page/migration/status`	Get migration status
POST	`/status-page/migration/cancel`	Cancel status page migration
POST	`/status-page/draft/create`	Create status page draft
GET	`/status-page/list`	List status pages
GET	`/status-page/info`	Get status page detail
POST	`/status-page/create`	Create status page
POST	`/status-page/update`	Update status page
POST	`/status-page/delete`	Delete status page
POST	`/status-page/component/upsert`	Upsert status page component
POST	`/status-page/component/delete`	Delete status page component
POST	`/status-page/section/upsert`	Upsert status page section
POST	`/status-page/section/delete`	Delete status page section
POST	`/status-page/template/upsert`	Upsert status page template
POST	`/status-page/template/delete`	Delete status page template
GET	`/status-page/template/list`	List status page templates

Changes

Method	Endpoint	Description
POST	`/change/list`	List changes

IM integrations

Method	Endpoint	Description
POST	`/datasource/im/war-room-enabled/list`	List war-room-enabled IM integrations

Monitors (25 endpoints)

Alert rules

Method	Endpoint	Description
POST	`/monit/rule/list/basic`	List alert rules
POST	`/monit/rule/v2/info`	Get alert rule detail (V2)
POST	`/monit/rule/v2/create`	Create alert rule (V2)
POST	`/monit/rule/v2/update`	Update alert rule (V2)
POST	`/monit/rule/delete`	Delete alert rule
POST	`/monit/rule/delete/batch`	Batch delete alert rules
POST	`/monit/rule/update/fields`	Batch update rule fields
POST	`/monit/rule/import`	Import alert rules
POST	`/monit/rule/export`	Export alert rules
POST	`/monit/rule/move`	Move alert rules to folder
POST	`/monit/rule/audits`	List rule change history
POST	`/monit/rule/audit/detail`	Get rule audit snapshot
POST	`/monit/rule/counter/total`	Get rule counter time series
POST	`/monit/rule/counter/channel`	Get rule counts by channel

Data sources

Method	Endpoint	Description
POST	`/monit/datasource/list`	List datasources
POST	`/monit/datasource/info`	Get datasource detail
POST	`/monit/datasource/create`	Create datasource
POST	`/monit/datasource/update`	Update datasource
POST	`/monit/datasource/delete`	Delete datasource
POST	`/monit/datasource/tools/invoke`	Invoke datasource tool
POST	`/monit/datasource/sls/projects`	List SLS projects
POST	`/monit/datasource/sls/logstores`	List SLS logstores
GET	`/monit/prometheus/api/v1/label/{label_name}/values`	List Prometheus label values

Diagnostics

Method	Endpoint	Description
POST	`/monit/query/data`	Query structured data
POST	`/monit/query/explore`	Run Explore query

Monitor utilities

Method	Endpoint	Description

RUM (41 endpoints)

Method	Endpoint	Description
POST	`/rum/facet/count`	Count facet value distribution
POST	`/rum/field/list`	List RUM fields

Applications

Method	Endpoint	Description
POST	`/rum/application/webhook/test`	Test application webhook
POST	`/rum/application/remote-config/history/revert`	Revert remote config
POST	`/rum/application/remote-config/history/list`	List remote config history
POST	`/rum/application/remote-config/preview`	Preview remote config
POST	`/rum/application/remote-config/update`	Update remote config
POST	`/rum/application/remote-config/get`	Get remote config detail
POST	`/rum/application/list`	List applications
POST	`/rum/application/infos`	Batch get applications
POST	`/rum/application/info`	Get application detail
POST	`/rum/application/delete`	Delete application
POST	`/rum/application/create`	Create application
POST	`/rum/application/update`	Update application

Issues

Method	Endpoint	Description
POST	`/rum/issue/export`	Export issues as CSV
POST	`/rum/issue/info`	Get issue detail
POST	`/rum/issue/list`	List issues
POST	`/rum/issue/update`	Update issue

Session replay

Method	Endpoint	Description
POST	`/rum/session-replay/metadata`	Get session replay metadata
POST	`/rum/session-replay/segments`	List session replay segments

Sourcemaps

Method	Endpoint	Description
POST	`/sourcemap/stack/enrich`	Enrich a stack trace
POST	`/sourcemap/list`	List sourcemaps

Data query

Method	Endpoint	Description
POST	`/rum/data/query`	Query RUM data

Error ingestion rules

Method	Endpoint	Description
POST	`/rum/error-ingestion/rules/list`	List error ingestion rules
POST	`/rum/error-ingestion/rules/create`	Create an error ingestion rule
POST	`/rum/error-ingestion/rules/update`	Update an error ingestion rule
POST	`/rum/error-ingestion/rules/delete`	Delete an error ingestion rule
POST	`/rum/error-ingestion/rules/enable`	Enable an error ingestion rule
POST	`/rum/error-ingestion/rules/disable`	Disable an error ingestion rule
POST	`/rum/error-ingestion/rules/history/list`	List error ingestion rule history
POST	`/rum/error-ingestion/rules/history/revert`	Revert error ingestion rules to a history version

Issue preset severity rules

Method	Endpoint	Description
POST	`/rum/issue/preset-severity/rules/list`	List preset severity rules
POST	`/rum/issue/preset-severity/rules/create`	Create preset severity rule
POST	`/rum/issue/preset-severity/rules/update`	Update preset severity rule
POST	`/rum/issue/preset-severity/rules/delete`	Delete preset severity rule
POST	`/rum/issue/preset-severity/rules/enable`	Enable preset severity rule
POST	`/rum/issue/preset-severity/rules/disable`	Disable preset severity rule
POST	`/rum/issue/preset-severity/rules/reorder`	Reorder preset severity rule
POST	`/rum/issue/preset-severity/rules/history/list`	List preset severity rule history
POST	`/rum/issue/preset-severity/rules/history/revert`	Revert preset severity rules to a history snapshot

Resources

Method	Endpoint	Description
POST	`/rum/resource/info`	Get RUM resource info

AI SRE (53 endpoints)

Skills

Method	Endpoint	Description
POST	`/safari/skill/list`	List skills
POST	`/safari/skill/get`	Get skill detail
POST	`/safari/skill/update`	Update skill
POST	`/safari/skill/delete`	Delete skill
POST	`/safari/skill/upload`	Upload skill
POST	`/safari/skill/enable`	Enable skill
POST	`/safari/skill/disable`	Disable skill

MCP servers

Method	Endpoint	Description
POST	`/safari/mcp/server/list`	List MCP servers
POST	`/safari/mcp/server/create`	Create MCP server
POST	`/safari/mcp/server/get`	Get MCP server detail
POST	`/safari/mcp/server/update`	Update MCP server
POST	`/safari/mcp/server/delete`	Delete MCP server
POST	`/safari/mcp/server/enable`	Enable MCP server
POST	`/safari/mcp/server/disable`	Disable MCP server

A2A agents

Method	Endpoint	Description
POST	`/safari/a2a-agent/create`	Create A2A agent
POST	`/safari/a2a-agent/list`	List A2A agents
POST	`/safari/a2a-agent/get`	Get A2A agent detail
POST	`/safari/a2a-agent/update`	Update A2A agent
POST	`/safari/a2a-agent/enable`	Enable A2A agent
POST	`/safari/a2a-agent/disable`	Disable A2A agent
POST	`/safari/a2a-agent/delete`	Delete A2A agent

Sessions

Method	Endpoint	Description
POST	`/safari/session/list`	List sessions
POST	`/safari/session/get`	Get session detail
POST	`/safari/session/export`	Export session transcript
POST	`/safari/session/delete`	Delete session

The POST /safari/session/get response includes a new pending_messages field, alongside events: the server-side projection of the human messages sitting in the session queue that the agent (actor) has not read yet, in execution order (head first), always an array (an empty array, never null, when nothing is queued). Each element has these fields:

Field	Type	Description
`invocation_id`	string	The call ID of the message (the ID handed out by the 202 ack / `user_message_enqueued` frame when the message was sent)
`client_msg_id`	string	Client-side message ID (optional)
`person_id`	int	Member ID of the message’s author
`steering`	boolean	Whether this is an interrupting (steer) message (optional)
`query`	string	The message text, consistent with the send-ack frame
`parts`	array	The message’s parts (`text` / `file` / `ref` / `skill`), passed through verbatim (optional)

Only plain human messages are projected: rows produced by internal producers (automation, child-session notifications, parent initial messages — they carry source) and question answers (function_response) are excluded; if the queue cannot be read, the field degrades to an empty array instead of failing the request. The projection matches the user_message_enqueued frame payload and is what clients use to render “sent but not yet handled” pending bubbles.

Automations

Method	Endpoint	Description
POST	`/safari/automation/rule/create`	Create Automation rule
POST	`/safari/automation/rule/list`	List Automation rules
POST	`/safari/automation/rule/get`	Get Automation rule
POST	`/safari/automation/rule/update`	Update Automation rule
POST	`/safari/automation/rule/delete`	Delete Automation rule
POST	`/safari/automation/template/list`	List Automation templates
POST	`/safari/automation/run/list`	List Automation runs
POST	`/safari/automation/rule/run`	Run Automation rule

Knowledge

Method	Endpoint	Description
POST	`/safari/knowledge/pack/list`	List knowledge packs
POST	`/safari/knowledge/get`	Get account knowledge pack
POST	`/safari/knowledge/pack/ensure`	Ensure knowledge pack
POST	`/safari/knowledge/pack/update`	Update knowledge pack
POST	`/safari/knowledge/pack/delete`	Delete knowledge pack
POST	`/safari/knowledge/file/list`	List knowledge files
POST	`/safari/knowledge/file/get`	Get knowledge file
POST	`/safari/knowledge/file/put`	Upload knowledge file
POST	`/safari/knowledge/file/delete`	Delete knowledge file

Artifacts

Method	Endpoint	Description
POST	`/safari/artifact/gallery/list`	List artifacts
POST	`/safari/artifact/gallery/get`	Get artifact detail
POST	`/safari/artifact/gallery/file-state`	Get file publish state
POST	`/safari/artifact/sign`	Create signed file URLs
GET	`/safari/artifact/stream`	Download or preview a file
POST	`/safari/artifact/gallery/publish-from-file`	Publish file as artifact
POST	`/safari/artifact/gallery/update`	Update artifact
POST	`/safari/artifact/gallery/delete`	Remove artifact from gallery
POST	`/safari/artifact/gallery/share/enable`	Enable public sharing
POST	`/safari/artifact/gallery/share/sync`	Update shared snapshot
POST	`/safari/artifact/gallery/share/revoke`	Revoke public sharing

Platform (27 endpoints)

Members

Method	Endpoint	Description
POST	`/member/info`	Get current member info
POST	`/member/list`	List members
POST	`/member/delete`	Delete member
POST	`/member/invite`	Invite members
POST	`/member/role/grant`	Grant role to member
POST	`/member/role/revoke`	Revoke role from member
POST	`/member/role/update`	Update member roles
POST	`/member/info/reset`	Reset member info
POST	`/person/infos`	Batch get persons

Teams

Method	Endpoint	Description
POST	`/team/info`	Get team detail
POST	`/team/infos`	Batch get teams
POST	`/team/list`	List teams
POST	`/team/upsert`	Create or update a team
POST	`/team/delete`	Delete a team

Roles & permissions

Method	Endpoint	Description
POST	`/role/info`	Get role detail
POST	`/role/list`	List roles
POST	`/role/upsert`	Create or update a role
POST	`/role/enable`	Enable a role
POST	`/role/disable`	Disable a role
POST	`/role/delete`	Delete a role
POST	`/role/permission/list`	List permissions
POST	`/role/permission/factor/list`	List permission factors
POST	`/role/member/grant`	Grant role to members
POST	`/role/member/revoke`	Revoke role from members

Audit logs

Method	Endpoint	Description
POST	`/audit/search`	Search audit logs
POST	`/audit/operation/list`	List auditable operation types

Account

Method	Endpoint	Description
POST	`/account/info`	Get account detail

​Incidents

​Channels

​Alerts

​Integrations

​Schedules

​Licenses

​Calendars

​Notification templates

​Alert enrichment

​Analytics

​Status pages

​Changes

​IM integrations

​Alert rules

​Data sources

​Diagnostics

​Monitor utilities

​Facets

​Applications

​Issues

​Session replay

​Sourcemaps

​Data query

​Error ingestion rules

​Issue preset severity rules

​Resources

​Skills

​MCP servers

​A2A agents

​Sessions

​Automations

​Knowledge

​Artifacts

​Members

​Teams

​Roles & permissions

​Audit logs

​Account

Incidents

Channels

Alerts

Integrations

Schedules

Licenses

Calendars

Notification templates

Alert enrichment

Analytics

Status pages

Changes

IM integrations

Alert rules

Data sources

Diagnostics

Monitor utilities

Facets

Applications

Issues

Session replay

Sourcemaps

Data query

Error ingestion rules

Issue preset severity rules

Resources

Skills

MCP servers

A2A agents

Sessions

Automations

Knowledge

Artifacts

Members

Teams

Roles & permissions

Audit logs

Account