メインコンテンツへスキップ

build-cloud-flow

dci build-cloud-flow

Creates a new CloudFlow and generates its nodes and connections based on the provided natural language intent. The operation streams incremental build events, including the ID of the newly created flow, as they are produced.

Request

Content-Type: application/json

Schema

{
"type": "object",
"required": [
"question"
],
"properties": {
"question": {
"type": "string",
"description": "Natural language description of the CloudFlow to build from scratch."
},
"conversationId": {
"type": "string",
"description": "ID of an existing conversation to continue. When omitted, a new conversation is started."
}
}
}

Responses

200 (text/event-stream)

OK - Build event stream.

{
"type": "string"
}

400 (application/json)

Bad Request - The server cannot process the request, often due to a malformed request.

{
"type": "object",
"description": "Standard error response structure.",
"properties": {
"error": {
"type": "string",
"description": "Detailed error message."
}
}
}

401 (application/json)

Unauthorized - Invalid API key.

{
"type": "object",
"description": "Standard error response structure.",
"properties": {
"error": {
"type": "string",
"description": "Detailed error message."
}
}
}

403 (application/json)

Forbidden - The client is not authorized to perform the request.

{
"type": "object",
"description": "Standard error response structure.",
"properties": {
"error": {
"type": "string",
"description": "Detailed error message."
}
}
}

406 (application/json)

Not Acceptable — the client did not include text/event-stream in the Accept header.

{
"type": "object",
"description": "Standard error response structure.",
"properties": {
"error": {
"type": "string",
"description": "Detailed error message."
}
}
}

500 (application/json)

Internal Server Error - Something went wrong with the DoiT API server.

{
"type": "object",
"description": "Standard error response structure.",
"properties": {
"error": {
"type": "string",
"description": "Detailed error message."
}
}
}

502 (application/json)

Bad Gateway — the upstream build service returned an unexpected error.

{
"type": "object",
"description": "Standard error response structure.",
"properties": {
"error": {
"type": "string",
"description": "Detailed error message."
}
}
}

Aliases: build-cloud-flow, buildcloudflow