Save the draft (lenient, structural-only)
Partial save of the draft definition/schemas. Runs STRUCTURAL (Zod) validation only — WIP graphs are allowed. Send the rev you last read; a stale rev returns 409. rev is trigger-owned and must not be sent in the payload. output_schema is optional and NOT enforced at run time — leave it unset unless you need a declared boundary contract; the actual output shape is whatever the last flow position returns (see the step-level schemas: tool outputSchema, agent step output_schema).
Authorizations
Org API key (scopes the request to its organization) or the shared trusted key (requires X-Organization-Id on every request).
Headers
Organization to scope the request to. Optional when authenticating with an org API key (the org is taken from the key; if sent, it must match). Required when authenticating with the trusted key.
End-user identity for the request; user-scoped data (threads, memory) resolves to {orgId}_{userId}. Required by endpoints that read or write user-scoped resources. A userId query param (or body field, where documented) is accepted as a fallback.
Path Parameters
Response
Saved