🚧

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.

Patches the Customer Agent resource for the calling company.

The request body data.id must match the path parameter.
Supports name, tone_of_voice, escalation_rules, and
communication_styles. For tone, provide
tone_of_voice.preset from the supported enum, or
preset: "custom" together with custom_instruction. For
escalation_rules and communication_styles, the supplied
array replaces the existing list; omit the field to leave the
existing list unchanged. Takes effect on the next turn.

Rate limits:
Burst: 10/s
Steady: 150/m

Scopes:
agents:write