Sign in

v51

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01206322659.2 KB
k2

Add a file to a knowledge base by upload or URL.

post/orgs/{org_id}/k2/{kb_id}/files

Path parameters

org_idstring required
kb_idstring required

Response

File uploaded

content_lengthinteger required
content_typestring required
created_atstring date-time required
directorystring nullable
idinteger required
kb_idinteger required
{"stackTrail":"components:schemas:K2File:properties:metadata","oasType":"schema","type":"unknown"}
namestring required
parse_statestring required

Pipeline state for parsing + embedding.

One of pending (pipeline in flight), success (parse + embed both completed), failed (latest attempt failed), or skipped (format unsupported, never parsed). Unsupported files are stored as-is; the indicator lets clients flag them in listings rather than rejecting the upload.

signed_urlstring nullable

CloudFront signed URL on the new CDN for private content. Omitted when signing is unavailable or the object is public.

uidstring required
updated_atstring date-time required
urlstring required

Deprecated: prefer signed_url when present. Kept for old clients.