HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Delete Agent Skill

🚧

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.

Permanently removes the skill from Customer Agent.

Past conversations routed to this skill are unchanged; future
conversations cannot route to it. To disable without deletion,
use PATCH /agent-skills/{id} with status: draft.

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

Scopes:
agents:write

Path Params
string
required
Headers
string
required
Defaults to 2026-04-15.pre

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

Responses
204

Success

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