PATCH /v1/flows/{id}
PATCH
/v1/flows/{id}
const url = 'https://seu-endereco-da-api/v1/flows/example';const options = { method: 'PATCH', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"name":"example","folderId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","ownerUserId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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).
Authorizations
Seção intitulada “Authorizations”Parameters
Seção intitulada “Parameters”Path Parameters
Seção intitulada “Path Parameters”id
required
string
Request Bodyrequired
Seção intitulada “Request Bodyrequired”Media typeapplication/json
object
name
string
folderId
string format: uuid
ownerUserId
string format: uuid
Example generated
{ "name": "example", "folderId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "ownerUserId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"}Responses
Seção intitulada “Responses”Media typeapplication/json
object
id
required
string
name
required
string
status
required
string
folderId
required
string
triggerType
required
string
triggerKeyword
required
string
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
publishedAt
required
string format: date-time
ownerUserId
required
Who receives the notice when the flow holds or fails messages
string
ownerName
required
string
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": [ {} ]}