HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Get Agent Skills

🚧

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.

Returns every skill configured for the calling company's Customer
Agent.

Use this to inspect Customer Agent's current skills before
adding or modifying a custom skill. Each item carries a prefixed
id, source, name, display_name, description,
instructions, bound agent-tools relationship data,
status, and handoff. Use retrieve to inspect any one
skill in detail.

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

Scopes:
agents:read

Query Params
fields[agent-skill]
array of strings
fields[agent-skill]
Headers
string
required
Defaults to 2026-04-15.pre

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

Responses

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