Skip to content

docs: add AI SRE automation API reference#122

Merged
debidong merged 1 commit into
mainfrom
codex/automation-via-chat-docs
Jun 29, 2026
Merged

docs: add AI SRE automation API reference#122
debidong merged 1 commit into
mainfrom
codex/automation-via-chat-docs

Conversation

@debidong

Copy link
Copy Markdown
Contributor

Summary

  • Add AI SRE Automation API Reference entries to safari and combined OpenAPI specs
  • Document rule create/list/get/update/delete, template list, run list, and HTTP POST trigger fire
  • Update Automations product docs for minute-level cron, current scope/permission rules, immutable scope, and HTTP POST trigger idempotency

Notes

  • HTTP POST trigger fire uses Bearer token auth and returns 202 Accepted
  • Create API still requires cron_expr even for HTTP-POST-only rules; CLI can hide this by sending a valid disabled schedule trigger
  • go-flashduty should consume this after this PR is merged, using the merge commit pseudo-version downstream

Verification

  • jq empty api-reference/safari.openapi.en.json api-reference/safari.openapi.zh.json api-reference/openapi.en.json api-reference/openapi.zh.json
  • Confirmed each of the four specs contains 8 /safari/automation/* paths
  • git diff --check
  • PATH=/Users/bowen/.cache/codex-runtimes/codex-primary-runtime/dependencies/node/bin:/Users/bowen/.goenv/shims:/opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/bin:/System/Cryptexes/App/usr/bin:/usr/bin:/bin:/usr/sbin:/sbin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/local/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/appleinternal/bin:/opt/pmk/env/global/bin:/usr/local/corplink/mdm/opt/corplink-mdm/bin:/Users/bowen/.codex/tmp/arg0/codex-arg0erhUi8:/Users/bowen/.cache/codex-runtimes/codex-primary-runtime/dependencies/bin:/Users/bowen/.local/bin:/Users/bowen/.kimi-code/bin:/Users/bowen/go/1.25.1/bin:/opt/homebrew/Caskroom/miniconda/base/bin:/opt/homebrew/Caskroom/miniconda/base/condabin:/opt/homebrew/opt/node/bin:/Users/bowen/.cargo/bin:/Users/bowen/.goenv/bin:/Users/bowen/.orbstack/bin:/Applications/Codex.app/Contents/Resources:/Users/bowen/.orbstack/bin mint broken-links

@mintlify

mintlify Bot commented Jun 29, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
flashduty 🟢 Ready View Preview Jun 29, 2026, 4:17 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@debidong
debidong merged commit f0fcf0d into main Jun 29, 2026
1 check passed
@debidong
debidong deleted the codex/automation-via-chat-docs branch June 29, 2026 05:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant