Skip to main content
PUT
Save a WhatsApp setup

Authorizations

Authorization
string
header
required

An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.

Headers

If-Match
string
required

The revision you read (its ETag, an integer in quotes such as "7"), so a stale write is refused with 412. Required: a write without it is refused with 428.

Pattern: ^(W/)?"?[0-9]+"?$
Example:

"\"7\""

Kallabot-Version
enum<string>

The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.

Available options:
2026-11-07
Example:

"2026-11-07"

Path Parameters

agent_id
string<uuid>
required

Body

application/json
draft
Draft · object
required

The studio editor's whole document, stored as sent (at most 256 KB).

Response

Successful Response

revision
integer
required

The setup's revision; 0 before the first save. Send it as If-Match.

draft
Draft · object | null

The editor document; null without agent:write.

updated_at
string | null

When it was last saved (ISO 8601).