Update Conversation

patch

https://a.klaviyo.com/api/customer-agent-conversations/{id}

🚧
This endpoint is in beta and subject to change.
A beta revision header (2026-07-15.pre) is required to use our beta APIs. Klaviyo APIs in beta are not intended for use in production. See our versioning and deprecation policy for more information.

Update a Customer Agent conversation.

status and customer are the only updatable attributes, and at least one must be provided. Only status: closed is accepted. customer can only be set once — a conversation that already has customer data rejects further updates.

Rate limits:
Burst: 3/s
Steady: 60/m

Scopes:
agents:write

OpenAPI Spec

Path Params

string

required

Query Params

fields[customer-agent-conversation]

array of strings

For more information please visit https://developers.klaviyo.com/en/v2026-07-15.pre/reference/api-overview#sparse-fieldsets

fields[customer-agent-conversation]

Allowed:

Body Params

Sparse request to update a Customer Agent conversation.

status and customer are the only updatable attributes, and at least one must be provided. Only status: closed is accepted today — the public surface exposes a single allowed transition (open → closed). Future statuses will require shared billing / event-emission plumbing currently coupled to the upstream-state-driven PUT. customer can only be set once: a conversation that already has customer identity data rejects further updates.

data

object

required

Headers

revision

string

required

Defaults to 2026-07-15.pre

API endpoint revision (format: YYYY-MM-DD[.suffix])

Responses

200Success

4XXClient Error

5XXServer Error