HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Update Agent Tool

🚧

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 the tool's config in place: protocol, templated request
configuration, variables, auth, and referenced secrets.

All skills bound to this tool pick up the new behavior
immediately on next call.

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

Scopes:
agents:write

Path Params
string
required
Query Params
fields[agent-tool]
array of strings
fields[agent-tool]
Body Params

Sparse request to update an external HTTP tool.

data
object
required
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