HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference
ChangelogHelp CenterCommunityContact Us

Create Agent Knowledge File

post
https://a.klaviyo.com/api/agent-knowledge-files

🚧

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.

Uploads a file (PDF, DOCX, TXT, etc.) and indexes its contents as
Agent Knowledge with source_type: file.

Returns the new Agent Knowledge resource immediately; clients
can poll its status until indexing completes.

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

Scopes:
agents:write

Query Params
fields[agent-knowledge]
array of strings

For more information please visit https://developers.klaviyo.com/en/v2026-04-15.pre/reference/api-overview#sparse-fieldsets

fields[agent-knowledge]
Body Params

Multipart body for creating file-backed Agent Knowledge.

string
required

Human-readable title for the file-backed knowledge item.

file
required

File to upload and index as Agent Knowledge.

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

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

Responses

Updated about 7 hours ago

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

Updated about 7 hours ago

Power smarter
digital relationships
By entering your information and clicking “Sign up,” you consent to receive marketing emails (such as newsletters, blog posts, webinars, event invitations and new product updates) from Klaviyo from time to time. You can unsubscribe at any time by clicking on the “Unsubscribe” link at the bottom of our emails. For more information on how we process your personal information and what rights you have in this respect, please see our Privacy Policy.
Terms and Privacy Trademarks Security