Applications

Update a data flow

Partial update — only the fields present in the body are applied.

Required scope applications:edit

patch/applications/{id}/flows/{flowId}

Authorizations

Authorizationstringrequired

Authorization header carrying a workspace API key, as “Bearer kbn_live_…”. The X-Api-Key header is accepted equivalently.

Path parameters

idstring<uuid>required

Identifier of the application. Must belong to the workspace the key is bound to.

flowIdstring<uuid>required

Identifier of the flow.

Bodyapplication/json

sourceIdstring<uuid>

Application emitting the flow.

targetIdstring<uuid>

Application receiving the flow.

dataIdsstring<uuid>[]

Data objects carried by the flow.

commentstring

Free-text note describing the flow.

protocolstring

Transport protocol carrying the flow.

formatstring

Payload format exchanged.

exchangeFrequencystring

How often the exchange runs.

portTypestring

Kind of port used.

portinteger

Network port used by the flow.

encryptedboolean

Whether the flow is encrypted in transit.

documentIdsstring<uuid>[]

Documents attached to the flow.

middlewaresobject[]

Middlewares the flow transits through, in order.

Response200 · application/json

The updated flow.

idstring<uuid>required

Unique identifier of the data flow.

commentstring | null

Free-text note describing the flow.

protocolstring | null

Transport protocol carrying the flow.

formatstring | null

Payload format exchanged.

exchangeFrequencystring | null

How often the exchange runs.

portTypestring | null

Kind of port used.

portinteger | null

Network port used by the flow.

encryptedboolean | null

Whether the flow is encrypted in transit.

sourceobjectrequired

Application the flow originates from.

targetobjectrequired

Application the flow is delivered to.

dataCountinteger

Number of data objects carried by the flow.

documentCountinteger

Number of documents attached to the flow.

middlewareCountinteger

Number of middlewares the flow transits through.