You need to enable JavaScript to run this app.
Lake AI Service

Lake AI Service

Copy page
Download PDF
Workflow template
CreateWorkflow - Create a workflow
Copy page
Download PDF
CreateWorkflow - Create a workflow
Create a workflow​
Debug​
API Explorer
You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.
​
Request parameters​
Only the request parameters specific to this API and some common parameters are listed below. For more information, see Common parameters.​
Action string required Example value: CreateWorkflow​
The operation to be performed. Value: CreateWorkflow.​
​
Version string required Example value: 2025-08-15​
API version. Value: 2025-08-15.​
​
Name string required Example value: workflow_name​
Workflow name​
​
Content string required Example value: For details, see the "Request parameter Content example" section below​
Workflow DAG content, orchestrated using argo yaml, except for specified parameters, fill in fixed values according to the template​
​
ClientToken string Optional Example value: uuid-xxxxxx​
Client token​
​
Description string Optional Example value: description​
Workflow description​
​
​
​
Response parameters​
Only the response parameters specific to this API are listed below. For more information, see Response structure.​
WorkflowId string Example value: wf-tpl-xxxx​
Workflow Id​
​
​
​
Request example​
​
POST https://open.volcengineapi.com​
{​
"Name": "workflow_name",​
"Content": "apiVersion: argoproj.io/v1alpha1\nkind: Workflow\nmetadata:\n generateName: las-task-\nspec:\n entrypoint: main\n templates:\n - name: main\n dag:\n tasks:\n - name: las-task\n templateRef:\n name: las-system-template\n template: las-task\n clusterScope: true\n arguments:\n parameters:\n - name: task_id\n value: \"Ray-xxx\"\n - name: task_resources\n value: '{\"QueueResourceId\":\"PUBLIC_resource_xxx\",\"RayParams\":{\"WorkerCpu\":1,\"WorkerMemory\":8,\"WorkerGpuNum\":1,\"HeadCpu\":1,\"HeadMemory\":4}}'",​
"ClientToken": "",​
"Description": "description"​
}​
​
Response example​
​
{​
"Result": {​
"WorkflowId": "wf-tpl-xxx"​
},​
"ResponseMetadata": {​
"Action": "CreateWorkflow",​
"Region": "cn-beijing",​
"Service": "las_ai_dev",​
"Version": "2025-08-15",​
"RequestId": "20230604110420****100232280022D31",​
"Deprecated": true​
}​
}​
​
Error codes​
The table below lists the error codes related to the business logic of this API. For common error codes, see the Common error codes documentation.​
​
Status code​
Error codes​
Error message​
Description​
400​
InvalidRequestParam​
Invalid request param {}, cause {}​
Invalid request parameter {}, cause {}​
400​
DryRunOperation​
The request is validated by a dryrun operation.​
This request is validated by a dryrun operation.​
400​
InvalidParameter​
The specified parameter {} is invalid.​
The specified parameter {} is invalid.​
400​
MissingParameter​
The required parameter {} is missing.​
The required parameter {} is missing.​
400​
EmptyResource​
Resource doesn't exist.​
Queue does not exist​
400​
InvalidRequest​
Content is required​
Content is required​
500​
InternalError​
The request has failed due to an unknown error.​
The request has failed due to an unknown error.​
​
Request parameter Content example​
​
apiVersion: argoproj.io/v1alpha1​
kind: Workflow​
spec:​
entrypoint: main​
templates:​
- name: main​
dag:​
tasks:# Node list. The example contains only two nodes. The execution order is id-mswovaco-0 -> id-mswovaco-1​
- name: id-mswovaco-0# Internal node id. The naming rule is id-8 lowercase letters-sequence number​
metadata:​
position:# Node position in the DAG. You can fill in the default value 0. The "Auto arrange" feature on the page can be used to adjust​
x: 0​
y: 0​
templateRef:​
name: las-system-template​
template: las-task​
clusterScope: true​
arguments:# Node parameters​
parameters:​
- name: task_id# Task template id​
value: t-uuid​
- name: task_parameters# Parameters for starting the task. JSON string in the body of the RunTaskInstance API​
value: '{"ResourceId":"resource_xxx","ResourceSpecGroupId":"0","Entrypoint":"xxx","DaftResourceConfig":{"WorkerCpuNum":1}}'​
- name: enable_retry# Whether to enable retry. The default value is false​
value: false​
- name: retry_times# Retry​
​
​
Last updated: 2026.08.18 16:09:15