Skip to main content
POST
Create a dynamic route

Authorizations

Authorization
string
header
required

Management API authentication. Pass an op-mak-… management token as a Bearer token. Runtime op-… API keys are rejected with 403 — they belong on the data-plane endpoints. Mint a management key from the platform UI under Settings → API keys.

Body

application/json
graph
object
required

The route graph (see DynamicRouteGraph): a START element; the answering and branching nodes; an END element; each wired to the next through its outputs.

name
string
required

Route name and the model id callers use to invoke it: lowercase letters and digits plus '.' '_' '-'; up to 128 characters; unique per organization.

deploy
boolean

When true the draft is validated and deployed as version 1 in the same call; the response then carries deployed_version in meta.

description
string

Free-text description shown in the platform.

layout
object

Editor canvas positions keyed by element id. Opaque to the gateway; omit when authoring from code.

note
string

Release note recorded on the deployed version. Only read when deploy is true.

Response

Successful response

data
object
meta
object