Skip to main content
GET
cURL
Listings from 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

Authorization
string
header
required

Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.

Path Parameters

org_id
string
required
kb_id
string
required
file_id
string
required

Response

200 - application/json

File details with parsings and embeddings

content_length
integer<int64>
required
content_type
string
required
created_at
string<date-time>
required
id
integer<int64>
required
kb_id
integer<int64>
required
metadata
any
required
name
string
required
parse_state
string
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.

uid
string
required
updated_at
string<date-time>
required
url
string
required
deprecated

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

embeddings
object[]
required
parsings
object[]
required
directory
string | null
signed_url
string | null

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