HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Create Agent Knowledge File

🚧

This endpoint is in beta and subject to change.

A beta revision header (2026-10-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

OpenAPI Spec

Query Params
fields[agent-knowledge]
array of strings
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.

string

Folder to create the item in. Omit to create it at the top level.

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

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

Responses

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