This endpoint is in beta and subject to change.
A beta revision header (2026-07-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 one or more fields on an existing skill: display_name, description, instructions, status, handoff, and the agent-tools relationship or named references used as {{tool ref=<name>}} in instructions.
Send instructions and references together when changing either one. They form one replacement document and are validated together. To rebind tools, send a new agent-tools relationship list; this is a full replacement, not merged. Skills are looked up by prefixed id. Use status: draft to pause a custom skill.
Rate limits:
Burst: 10/s
Steady: 150/m
Scopes:
agents:write