# Create versions URL: https://docs.hanzo.ai/docs/openapi/auto/post-auto-flows-by-id-versions > Adds a new DRAFT version to a flow. `POST /v1/auto/flows/{id}/versions` > [Auto →](https://docs.hanzo.ai/docs/openapi/auto) · [All API references →](https://docs.hanzo.ai/docs/openapi) · [Get started →](https://docs.hanzo.ai/docs/guides) | | | | ------------- | -------------------------------------------------- | | **Address** | `https://api.hanzo.ai/v1/auto/flows/{id}/versions` | | **Method** | `POST` | | **Operation** | `post_auto_flows_by_id_versions` | | **Auth** | `Authorization: Bearer $HANZO_API_KEY` | Adds a new DRAFT version to a flow. The version is created invalid unless it carries a trigger, and it does not become the running version until it is published (PATCH the flow's publishedVersionId) or becomes the latest. ## Request 30 fields, body `application/json` (required). | Field | In | Type | Required | Description | | ------------------------------------------ | ---- | ----------------- | -------- | -------------------------------------------------- | | `id` | path | string | yes | ID is the flow to add a version to, from the path. | | `displayName` | body | string | — | DisplayName names the new version. | | `id` | body | string | — | ID is the flow to add a version to, from the path. | | `trigger` | body | auto.FlowTrigger | — | | | `trigger.displayName` | body | string | — | | | `trigger.name` | body | string | — | | | `trigger.nextAction` | body | auto.FlowAction | — | | | `trigger.nextAction.displayName` | body | string | — | | | `trigger.nextAction.name` | body | string | — | | | `trigger.nextAction.nextAction` | body | auto.FlowAction | — | | | `trigger.nextAction.settings` | body | auto.StepSettings | — | | | `trigger.nextAction.settings.actionName` | body | string | — | | | `trigger.nextAction.settings.input` | body | object | — | | | `trigger.nextAction.settings.input.*` | body | any | — | | | `trigger.nextAction.settings.pieceName` | body | string | — | | | `trigger.nextAction.settings.pieceVersion` | body | string | — | | | `trigger.nextAction.settings.triggerName` | body | string | — | | | `trigger.nextAction.skip` | body | boolean | — | | | `trigger.nextAction.type` | body | string | — | PIECE \| CODE \| ROUTER \| LOOP\_ON\_ITEMS | | `trigger.nextAction.valid` | body | boolean | — | | | `trigger.settings` | body | auto.StepSettings | — | | | `trigger.settings.actionName` | body | string | — | | | `trigger.settings.input` | body | object | — | | | `trigger.settings.input.*` | body | any | — | | | `trigger.settings.pieceName` | body | string | — | | | `trigger.settings.pieceVersion` | body | string | — | | | `trigger.settings.triggerName` | body | string | — | | | `trigger.strategy` | body | string | — | | | `trigger.type` | body | string | — | PIECE\_TRIGGER \| EMPTY | | `trigger.valid` | body | boolean | — | | ## Response | Status | Body | Meaning | | --------- | ---------------- | ------- | | `201` | auto.FlowVersion | created | | `default` | problem-details | refused | `201` body — 35 fields. | Field | In | Type | Always | Description | | ------------------------------------------ | ---- | ----------------- | ------ | ------------------------------------------ | | `created` | body | integer (int64) | — | | | `displayName` | body | string | — | | | `flowId` | body | string | — | | | `id` | body | string | — | | | `schemaVersion` | body | string | — | | | `state` | body | string | — | | | `trigger` | body | auto.FlowTrigger | — | | | `trigger.displayName` | body | string | — | | | `trigger.name` | body | string | — | | | `trigger.nextAction` | body | auto.FlowAction | — | | | `trigger.nextAction.displayName` | body | string | — | | | `trigger.nextAction.name` | body | string | — | | | `trigger.nextAction.nextAction` | body | auto.FlowAction | — | | | `trigger.nextAction.settings` | body | auto.StepSettings | — | | | `trigger.nextAction.settings.actionName` | body | string | — | | | `trigger.nextAction.settings.input` | body | object | — | | | `trigger.nextAction.settings.input.*` | body | any | — | | | `trigger.nextAction.settings.pieceName` | body | string | — | | | `trigger.nextAction.settings.pieceVersion` | body | string | — | | | `trigger.nextAction.settings.triggerName` | body | string | — | | | `trigger.nextAction.skip` | body | boolean | — | | | `trigger.nextAction.type` | body | string | — | PIECE \| CODE \| ROUTER \| LOOP\_ON\_ITEMS | | `trigger.nextAction.valid` | body | boolean | — | | | `trigger.settings` | body | auto.StepSettings | — | | | `trigger.settings.actionName` | body | string | — | | | `trigger.settings.input` | body | object | — | | | `trigger.settings.input.*` | body | any | — | | | `trigger.settings.pieceName` | body | string | — | | | `trigger.settings.pieceVersion` | body | string | — | | | `trigger.settings.triggerName` | body | string | — | | | `trigger.strategy` | body | string | — | | | `trigger.type` | body | string | — | PIECE\_TRIGGER \| EMPTY | | `trigger.valid` | body | boolean | — | | | `updated` | body | integer (int64) | — | | | `valid` | body | boolean | — | | Failure carries the platform error shape — see [Errors](https://docs.hanzo.ai/docs/errors). ## Examples **CLI** ```bash hanzo auto flows versions create ``` **SDK** **.ts** ```ts import { Configuration, AutoApi } from 'hanzoai'; const api = new AutoApi(new Configuration({ accessToken: process.env.HANZO_API_KEY })); const { data } = await api.postAutoFlowsByIdVersions({ id: 'id', displayName: "", id: "" }); ``` **.py** ```python from hanzoai.cloud import ApiClient, Configuration from hanzoai.cloud.api import AutoApi client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"])) result = AutoApi(client).post_auto_flows_by_id_versions(id='id', display_name="", id="") ``` **.go** ```go cfg := hanzoai.NewConfiguration() cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY")) client := hanzoai.NewAPIClient(cfg) resp, _, err := client.AutoAPI.PostAutoFlowsByIdVersions(context.Background()).Execute() if err != nil { return err } ``` **.rs** ```rust use hanzo_client::apis::{configuration::Configuration, auto_api}; let mut cfg = Configuration::new(); cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok(); let result = auto_api::post_auto_flows_by_id_versions(&cfg, Default::default()).await?; ``` **.java** ```java import ai.hanzo.cloud.ApiClient; import ai.hanzo.cloud.api.AutoApi; ApiClient client = new ApiClient(); client.setBearerToken(System.getenv("HANZO_API_KEY")); var result = new AutoApi(client).postAutoFlowsByIdVersions(); ``` **HTTP** ```bash curl -X POST https://api.hanzo.ai/v1/auto/flows//versions \ -H "Authorization: Bearer $HANZO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "displayName": "", "id": "" }' ``` **MCP** MCP reaches **auto** through the `auto` tool, which names its 14 operations with its own verbs — this one among them, under a name only MCP declares. `describe` explains any of them: ```bash curl -X POST https://api.hanzo.ai/v1/mcp \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "describe", "arguments": { "op": "list_auto_flows" } } }' ``` --- [Auto API](https://docs.hanzo.ai/docs/openapi/auto) · [All Hanzo APIs](https://docs.hanzo.ai/docs/openapi) · [Interactive reference](https://docs.hanzo.ai/docs/openapi/reference)