Evaluate an inline blueprint (synchronous, ephemeral)
POST/evaluate/inline
Evaluate a single Make.com blueprint passed in the request body and get the full governance result back in one call — violations, the canvas module graph, per-violation remediation availability, and (optionally) step-by-step remediation.
Unlike POST /evaluate (asynchronous — returns a token you poll), this
is synchronous and ephemeral: the blueprint is evaluated in memory
and never stored (no evaluation row, result token, or webhook). The
caller needs only the blueprint — no scenario has to pre-exist in
FlowBeacon. Ideal for real-time governance where you
already hold the blueprint (e.g. fetched from the Make API by id).
Shares the daily evaluation quota and the 5 MB body ceiling with
POST /evaluate. Set include_remediation=true to also receive
step-by-step fix guidance per violation (higher latency).
Remediation time budget. Remediation steps are generated per
violation and run concurrently under an overall wall-clock budget kept
below the gateway timeout, so the call always returns promptly instead of
timing out. Violations whose steps complete within the budget include a
remediation block; any that do not are returned with
remediation_pending: true and no steps. Latency scales with the number
of violations, so for blueprints with many findings expect some
violations to come back pending under load.
Request
Responses
- 200
- 400
- 401
- 403
- 413
- 422
- 429
- 500
- 503
Full evaluation result.
Malformed request.
Missing or invalid Authorization header or API key.
Auth succeeded but the action is not permitted.
Reduce payload size below 10 MB.
Request body failed schema validation (missing/!wrong-typed fields).
Returned in the standard public envelope; the field-level errors are
preserved under detail (FastAPI's validation error list).
Rate limit exceeded. Honor Retry-After. Defaults: 60 RPM / 1000 RPH per key.
Response Headers
Seconds to wait before retrying.
Internal server error.
Public API is disabled by an emergency kill-switch.