FlowRelay
Reference
OpenAPI
Generated OpenAPI schema discovery and public contract placement for Agent Operations.
On this page
Schema location #
Use the OpenAPI document for exact field names, types, and shapes. Use these prose docs for product meaning, delivery semantics, and safe guidance. The two are complementary; neither replaces the other.
| 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/ |
| Choose an agent mission | 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 #
The current generated Agent Operations schema version is 2026-06-17. Generated schema versions move with the canonical operation registry; agents re-read the manifest and OpenAPI document before relying on cached operation names or schemas.
Operation names #
Use generated operation IDs for clients. The public manifest operation is getAgentOperationsManifest. Keep examples synthetic and redacted, and do not include real tokens, authentication headers, event bodies, or customer records.
Examples #
The generated OpenAPI document includes synthetic request examples for endpoint creation, replay preview and execution, diagnostics sharing, support preview and submit, expansion requests, and feature requests. Use those schema-bound examples instead of copying production requests.
curl -s https://docs.flowrelay.app/reference/openapi/agent-operations.openapi.json \
| jq -r '.paths[][] | select(.operationId) | .operationId'Generated clients #
If you generate a client from the schema, preserve refusal handling, idempotency keys, docs URLs in refusals, and the action-preview lifecycle. These behaviors are part of the Agent Operations contract and must remain visible in your client.