CreateFlow-阿里云帮助中心

Creates a flow.

Operation description

Creates a flow or a flow version.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
FlowId	string	No	The ID of the flow. This parameter is required when you update a flow or create a new flow version.	flow-647da8e366a74d1cab6e
FlowName	string	Yes	The name of the flow.	企业微信自建应用大模型自动回复
FlowDesc	string	No	The description of the flow.	在钉钉中使用OpenClaw(MoltBot、MoltBot)
FlowTemplate	string	No	The content of the template.	{ "FormatVersion": "appflow-2025-07-01", "Nodes": [ ] }
TemplateId	string	No	The ID of the template. Specify this parameter when you create a flow from a template in the Template Center.	tl-715d93e708b546b7b464
Parameters	array<object>	No	The parameters for the template. You can specify up to 200 parameters. Note This parameter is optional. If you use this parameter, you must specify both ParameterKey and ParameterValue for each entry.
	object	No	A template parameter.
ParameterKey	string	No	The name of a parameter defined in the template. If no parameter name or value is specified, ROS uses the default value defined in the template. The maximum value of N is 200. The name must be 1 to 128 characters in length, cannot start with `aliyun` or `acs:`, and cannot contain `http://` or `https://`. Note Parameters is optional. If you specify Parameters, you must specify both Parameters.N.ParameterKey and Parameters.N.ParameterValue.	dingdingAuthId
ParameterValue	string	No	The value for the parameter.	uac-xxxxxxx
Tag	array<object>	No	The object tags to which the rule applies. You can specify multiple tags.
	object	No	A resource tag.
Key	string	No	The tag key. You can filter the cluster list by tag. You can specify up to 20 tag pairs. The number N in each tag pair must be unique and a consecutive integer starting from 1. The value corresponding to `Tag.N.Key` is `Tag.N.Value`. Note The tag key can be up to 64 characters long and cannot start with `aliyun`, `acs:`, `http://`, or `https://`.	CreateBy
Value	string	No	The authentication content.	zhangsan
LaunchStatus	boolean	No	The publication status of the flow: True for published, False for unpublished.	true

Response elements

Element	Type	Description	Example
	object	The response schema.
RequestId	string	The request ID.	32F02021-11D2-5196-BC85-72890E9AA090
Data	string	The information of the newly created product returned when the call succeeds.	flow-9691a04fc7f94525aac1

Examples

Success response

JSON format

{
  "RequestId": "32F02021-11D2-5196-BC85-72890E9AA090",
  "Data": "flow-9691a04fc7f94525aac1"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.