Skip to main content
POST
Deprecate flow

Concepts

Marks the flow as DEPRECATED. It stops accepting new openings, but sessions already running go through to the end. Use it when you publish a new version of the flow and want to retire the old one without cutting off people mid-form.
Deprecating cannot be undone.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

wabaId
string
required

WABA ID (obtained via List WABAs)

Example:

"428083093730937"

flowId
string
required

Flow ID (obtained via List flows)

Example:

"1122334455667788"

Response

Operation completed successfully

id
string

Flow ID

name
string

Flow name

categories
enum<string>[]

Flow categories (Meta uses them during review)

Available options:
SIGN_UP,
SIGN_IN,
APPOINTMENT_BOOKING,
LEAD_GENERATION,
CONTACT_US,
CUSTOMER_SUPPORT,
SURVEY,
OTHER
status
enum<string>

Publication status

Available options:
DRAFT,
PUBLISHED,
DEPRECATED,
BLOCKED,
THROTTLED
endpoint_uri
string | null

Your endpoint URL, required only for flows using data_exchange

flow_json
string

Screen definition in JSON, sent as a string

validation_errors
object[]

Validation issues returned by Meta