Sign in

v51

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

Get a file with its parsings and embeddings metadata

get/orgs/{org_id}/k2/{kb_id}/files/{file_id}

Path parameters

org_idstring required
kb_idstring required
file_idstring required

Response

File details with parsings and embeddings

content_lengthinteger required
content_typestring required
created_atstring date-time required
directorystring nullable
idinteger required
kb_idinteger required
{"stackTrail":"components:schemas:GetK2FileResponse:allOf: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.