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-10-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, customer, and profile are the only updatable fields, and at least one must be provided. Only status: closed is accepted. customer can only be set once. profile can be added once, including to a conversation that already has customer, to sign the customer in.

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-10-15.pre/reference/api-overview#sparse-fieldsets

fields[customer-agent-conversation]

Body Params

Sparse request to update a Customer Agent conversation.

status, customer, and profile are the only updatable fields, 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, and profile can be added once, including to a conversation that already has customer.

data

object

required

Headers

revision

string

required

Defaults to 2026-10-15.pre

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

Responses

200Success

4XXClient Error

5XXServer Error