Pular para o conteúdo

PATCH /v1/flows/{id}

PATCH
/v1/flows/{id}
curl --request PATCH \
--url https://seu-endereco-da-api/v1/flows/example \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "name": "example", "folderId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "ownerUserId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'

Permissão que a Chave de acesso precisa: Gerenciar fluxos (flows:manage).

id
required
string
Media typeapplication/json
object
name
string
>= 1 characters
folderId
string format: uuid
nullable
ownerUserId
string format: uuid
nullable

Example generated

{
"name": "example",
"folderId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"ownerUserId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}
Media typeapplication/json
object
id
required
string
name
required
string
status
required
string
folderId
required
string
nullable
triggerType
required
string
triggerKeyword
required
string
nullable
triggerChannel
required
string
triggerAccounts
required

Ids dos canais do gatilho; vazio atende todos os canais

Array<string>
version
required
number
origin
required
string
companionAgentId
required

Agente de IA que criou o fluxo junto com ele, quando veio de uma IA pronta

string
nullable
publishedAt
required
string format: date-time
nullable
ownerUserId
required

Who receives the notice when the flow holds or fails messages

string
nullable
ownerName
required
string
nullable
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
nodeCount
number
warnings
Array<object>
object

Example generated

{
"id": "example",
"name": "example",
"status": "example",
"folderId": "example",
"triggerType": "example",
"triggerKeyword": "example",
"triggerChannel": "example",
"triggerAccounts": [
"example"
],
"version": 1,
"origin": "example",
"companionAgentId": "example",
"publishedAt": "2026-04-15T12:00:00Z",
"ownerUserId": "example",
"ownerName": "example",
"createdAt": "2026-04-15T12:00:00Z",
"updatedAt": "2026-04-15T12:00:00Z",
"nodeCount": 1,
"warnings": [
{}
]
}