HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Start Customer Agent Training Run

🚧

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.

Start training for the specified Customer Agent and return its current status.

Returns 409 Conflict if training is already pending or running. Poll Get Customer Agent Training Runs to monitor progress. You can start another run after the current run succeeds or fails.

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

Scopes:
agents:write

OpenAPI Spec

Query Params
fields[customer-agent-training-run]
array of strings
fields[customer-agent-training-run]
Allowed:
Body Params

Start training for a Customer Agent belonging to the authenticated account.

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

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

Responses

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