Skip to content
Last updated

Represents a file uploaded to an organization for use in vector stores, file search, or AI conversations.

Attributes

id string

Unique identifier for the file (format: file_*).

original_filename string

Original filename of the uploaded file.

file_size integer

File size in bytes.

mime_type string

MIME type of the file (e.g., application/pdf, text/plain).

storage_path string

Path where the file is stored in cloud storage.

organization_id string

ID of the organization that owns this file.

uploaded_by string | null

User ID of the person who uploaded the file. Null if uploaded via API key.

uploaded_by_api_key_id string | null

API key ID used to upload the file. Null if uploaded by user.

uploaded_at string (ISO 8601)

Timestamp when the file was uploaded.


Example

{
  "id": "file_abc123xyz789",
  "original_filename": "product_documentation.pdf",
  "file_size": 2457600,
  "mime_type": "application/pdf",
  "storage_path": "files/org_abc123/file_abc123xyz789/product_documentation.pdf",
  "organization_id": "org_abc123",
  "uploaded_by": "usr_user123",
  "uploaded_by_api_key_id": null,
  "uploaded_at": "2025-01-20T15:30:00Z"
}