🚧

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 one or more fields on an existing skill: display_name,
description, instructions, status, handoff, and the
agent-tools relationship.

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