Skip to main content
PUT
Update a WhatsApp Flow
Updates a Flow’s metadata and, when flow_data is present, re-uploads its Flow JSON to Meta.
Meta does not allow editing a Flow that is already published. Update the Flow while it is still a draft, or create a new one and switch your sends over to its meta_flow_id.

Endpoint

Required scope

flows:write

Body

Example request

curl

Response

200 OK

The updated Flow, same shape as GET /v1/flows/{id}.

400 Bad Request

Invalid id, invalid Flow JSON, or Meta refused the update because the Flow is published.

404 Not Found

FLOW_NOT_FOUND.

Authorizations

Authorization
string
header
required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Path Parameters

id
string
required

Body

application/json
name
string
Maximum string length: 100
description
string
Maximum string length: 500
categories
enum<string>[]
Available options:
OTHER,
SIGN_UP,
SIGN_IN,
APPOINTMENT_BOOKING,
LEAD_GENERATION,
CONTACT_US,
CUSTOMER_SUPPORT,
SURVEY
flow_data
object

Replacement Flow JSON. Re-uploaded as the Flow asset at Meta.

metadata
object

Response

200 - application/json
id
string
required

Keebai flow id.

channel_id
string
required

Keebai channel this Flow belongs to.

name
string
required
categories
enum<string>[]
required
Available options:
OTHER,
SIGN_UP,
SIGN_IN,
APPOINTMENT_BOOKING,
LEAD_GENERATION,
CONTACT_US,
CUSTOMER_SUPPORT,
SURVEY
status
enum<string>
required
Available options:
draft,
published,
archived
description
string | null
meta_flow_id
string | null

Meta Flow id. Use it as flow_id when sending a message of type flow. Null until Meta accepts the Flow.

flow_data
object

Flow JSON currently stored in Keebai.

metadata
object
created_at
string<date-time> | null
updated_at
string<date-time> | null