Upload flow JSON - Kapso Documentation

POST

{flow_id}

assets

Upload flow JSON

curl --request POST \
  --url https://api.kapso.ai/meta/whatsapp/v24.0/{flow_id}/assets \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-API-Key: <api-key>' \
  --form file='@example-file' \
  --form name=flow.json \
  --form asset_type=FLOW_JSON

{
  "success": true,
  "validation_errors": []
}

Authorizations

X-API-Key

string

header

required

Project API key for authentication. This is the recommended authentication method.

Get your API key from the Kapso dashboard under Integrations > API keys.

Path Parameters

flow_id

string

required

Flow ID

Body

multipart/form-data

file

required

Flow JSON file (max 10 MB)

name

string

required

Asset name (must be "flow.json")

Example:

"flow.json"

asset_type

string

required

Asset type (must be "FLOW_JSON")

Example:

"FLOW_JSON"

Response

Flow assets uploaded successfully

success

boolean

validation_errors

object[]

Show child attributes

Get flow detailsRetrieve detailed information about a specific flow. By default returns: id, name, status, categories, validation_errors. Use `fields` parameter to request additional information like preview URLs, health status, metrics, etc. **Proxy endpoint**: Proxies directly to Meta Graph API.

Upload flow JSON

curl --request POST \
  --url https://api.kapso.ai/meta/whatsapp/v24.0/{flow_id}/assets \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-API-Key: <api-key>' \
  --form file='@example-file' \
  --form name=flow.json \
  --form asset_type=FLOW_JSON

{
  "success": true,
  "validation_errors": []
}