HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference
ChangelogHelp CenterCommunityContact Us

Update Conversation

patch
https://a.klaviyo.com/api/customer-agent-conversations/

🚧

This endpoint is in beta and subject to change.

A beta revision header (2026-04-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.

Close a Customer Agent conversation.

status is the only updatable attribute and only closed
is accepted (the DTO's Literal constraint enforces this
before this handler runs).

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

Scopes:
agents:write

Path Params
string
required
Query Params
fields[customer-agent-conversation]
array of strings

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

fields[customer-agent-conversation]
Body Params

Sparse request to update a Customer Agent conversation.

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.

data
object
required
Headers
string
required
Defaults to 2026-04-15.pre

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

Responses

Updated about 7 hours ago

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/vnd.api+json

Updated about 7 hours ago

Power smarter
digital relationships
By entering your information and clicking “Sign up,” you consent to receive marketing emails (such as newsletters, blog posts, webinars, event invitations and new product updates) from Klaviyo from time to time. You can unsubscribe at any time by clicking on the “Unsubscribe” link at the bottom of our emails. For more information on how we process your personal information and what rights you have in this respect, please see our Privacy Policy.
Terms and Privacy Trademarks Security