Reference
OpenAPI
Generated OpenAPI schema discovery and public contract placement for Agent Operations.
Schema location #
Use the generated OpenAPI document for exact request and response fields. Use the prose docs for product meaning and safe operating guidance.
| Artifact | URL |
|---|---|
| OpenAPI JSON | https://docs.flowrelay.app/reference/openapi/agent-operations.openapi.json |
| Trigger mapping reference | https://docs.flowrelay.app/setup/trigger-variants-and-event-mapping/ |
| Agent mission playbooks | https://docs.flowrelay.app/agent-access/agent-mission-playbooks/ |
| Availability and refusals | https://docs.flowrelay.app/agent-access/availability-and-refusals/ |
| Agent orientation | https://docs.flowrelay.app/agent-access/agent-orientation/ |
| Docs index | https://docs.flowrelay.app/llms.txt |
Versioning #
Generated schema versions move with the Agent Operations contract. Agents re-read the manifest and OpenAPI document before relying on cached operation names or schemas.
Operation names #
Use stable operation IDs for generated clients. Keep docs examples synthetic and redacted, and do not include real tokens, authentication headers, event bodies, or customer records.
Generated clients #
Generated clients preserve refusal handling, idempotency, docs URLs, and action-preview semantics rather than hiding those details behind a generic SDK.
FlowRelay