Import a flow as a new draft
POST/v1/pathways/:id/import
Import a complete flow_json (typically AI-authored) as a new draft version, optionally activating it with ?activate=true. Hard-gated by validation — an import must be activatable as-is; on failure nothing is written and the errors come back (400). Requires an owner-bound key whose owner is an engineer.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 429
The flow failed validation (returned as errors).
Missing, invalid, revoked, or expired API key.
The key lacks the pathways:write scope, is not owner-bound, or its owner is not an engineer.
No pathway with this id for your organization.
Rate limit exceeded.