Pular para o conteúdo

POST /v1/flow-http-connections

POST
/v1/flow-http-connections
curl --request POST \
--url https://seu-endereco-da-api/v1/flow-http-connections \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "name": "example", "method": "GET", "url": "https://example.com", "headers": [ { "key": "example", "value": "example" } ], "queryParams": [ { "key": "example", "value": "example" } ], "auth": { "kind": "bearer", "token": "example", "user": "example", "password": "example", "headerName": "example", "value": "example" }, "body": "example", "originFlowId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "showInChat": true }'

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

Media typeapplication/json
object
name
required
string
>= 1 characters <= 120 characters
method
required
string
Allowed values: GET POST PUT PATCH DELETE
url
required
string format: uri
headers
required
Array<object>
object
key
required
string
>= 1 characters <= 200 characters
value
required
string
<= 4000 characters
queryParams
Array<object>
object
key
required
string
>= 1 characters <= 200 characters
value
required
string
<= 4000 characters
auth
object
kind
required
string
Allowed values: bearer basic api_key
token
string
>= 1 characters <= 4000 characters
user
string
>= 1 characters <= 200 characters
password
string
>= 1 characters <= 200 characters
headerName
string
>= 1 characters <= 200 characters
value
string
>= 1 characters <= 4000 characters
body
string
<= 32000 characters
originFlowId
string format: uuid
showInChat
boolean
Media typeapplication/json
object
id
required
string
name
required
string
method
required
string
url
required
string
queryParams
required

Key/value pairs appended to the URL as the query string

Array<object>
object
hasHeaders
required

The stored headers are never returned, only whether they exist

boolean
authKind
required

The stored credential is never returned, only its kind

string
nullable
body
required
string
nullable
origin
required

Flow where the connection was created; flowName is null when that flow was deleted

object
showInChat
required

A conexão aparece no botão Consultar sistema da conversa

boolean
active
required

Turned off automatically after repeated failures

boolean
disabledAt
required
string format: date-time
nullable
createdAt
required
string format: date-time
updatedAt
required
string format: date-time

Example generated

{
"id": "example",
"name": "example",
"method": "example",
"url": "example",
"queryParams": [
{}
],
"hasHeaders": true,
"authKind": "example",
"body": "example",
"origin": {},
"showInChat": true,
"active": true,
"disabledAt": "2026-04-15T12:00:00Z",
"createdAt": "2026-04-15T12:00:00Z",
"updatedAt": "2026-04-15T12:00:00Z"
}