Get File
Get a file with its parsings and embeddings metadata
GET /orgs/{org_id}/k2/{kb_id}/files include folder rows (content_type application/vnd.timbal.k2-directory). This get file endpoint is only for regular uploaded files (parsings, embeddings, etc.).
If you pass a directory row’s id from the list endpoint, the API responds with 404 Not Found — virtual directories do not have a full file payload here.Authorizations
Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.
Response
File details with parsings and embeddings
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.
Deprecated: prefer signed_url when present. Kept for old clients.
CloudFront signed URL on the new CDN for private content. Omitted when signing is unavailable or the object is public.