POST
/
upload_text

Authorizations

authorization
string
headerrequired

token <token>, corresponds to temporary access tokens.

Body

application/json
contents
string
required
Minimum length: 5
name
string | null
chunk_size
integer | null
chunk_overlap
integer | null
skip_embedding_generation
boolean
default: false
overwrite_file_id
integer | null
embedding_model
enum<string> | null
Available options:
OPENAI,
AZURE_OPENAI,
AZURE_ADA_LARGE_256,
AZURE_ADA_LARGE_1024,
AZURE_ADA_LARGE_3072,
AZURE_ADA_SMALL_512,
AZURE_ADA_SMALL_1536,
COHERE_MULTILINGUAL_V3,
VERTEX_MULTIMODAL,
OPENAI_ADA_LARGE_256,
OPENAI_ADA_LARGE_1024,
OPENAI_ADA_LARGE_3072,
OPENAI_ADA_SMALL_512,
OPENAI_ADA_SMALL_1536,
SOLAR_1_MINI
generate_sparse_vectors
boolean | null
default: false
cold_storage_params
object
generate_chunks_only
boolean
default: false

If this flag is enabled, the file will be chunked and stored with Carbon, but no embeddings will be generated. This overrides the skip_embedding_generation flag.

store_file_only
boolean
default: false

If this flag is enabled, the file will be stored with Carbon, but no processing will be done.

Response

200 - application/json
id
integer
required
source
enum<string>
required
Available options:
GOOGLE_CLOUD_STORAGE,
GOOGLE_DRIVE,
NOTION,
NOTION_DATABASE,
INTERCOM,
DROPBOX,
ONEDRIVE,
SHAREPOINT,
CONFLUENCE,
BOX,
ZENDESK,
ZOTERO,
S3,
AZURE_BLOB_STORAGE,
GMAIL,
OUTLOOK,
SERVICENOW,
TEXT,
CSV,
TSV,
PDF,
DOCX,
PPTX,
XLSX,
XLSM,
MD,
RTF,
JSON,
HTML,
RAW_TEXT,
WEB_SCRAPE,
RSS_FEED,
FRESHDESK,
GITBOOK,
SALESFORCE,
GITHUB,
SLACK,
GURU,
GONG,
DOCUMENT360,
JPG,
PNG,
JPEG,
MP3,
MP2,
AAC,
WAV,
FLAC,
PCM,
M4A,
OGG,
OPUS,
MPEG,
MPG,
MP4,
WMV,
AVI,
MOV,
MKV,
FLV,
WEBM,
EML,
MSG
organization_id
integer
required
organization_user_id
integer | null
required
organization_supplied_user_id
string
required
external_file_id
string
required
sync_status
enum<string>
required
Available options:
DELAYED,
QUEUED_FOR_SYNC,
SYNCING,
READY,
SYNC_ERROR,
EVALUATING_RESYNC,
RATE_LIMITED,
SYNC_ABORTED,
QUEUED_FOR_OCR,
READY_TO_SYNC
skip_embedding_generation
boolean
required
supports_cold_storage
boolean
required
embedding_storage_status
enum<string>
required
Available options:
HOT_STORAGE,
HOT_TO_COLD,
COLD_STORAGE,
COLD_TO_HOT
created_at
string
required
updated_at
string
required
organization_user_data_source_id
integer | null
external_url
string | null
sync_error_message
string | null
last_sync
string | null
tags
object | null
file_statistics
object | null
file_metadata
object | null
embedding_properties
object | null
chunk_size
integer | null
chunk_overlap
integer | null
chunk_properties
object | null
ocr_properties
object
ocr_job_started_at
string | null
name
string | null
parent_id
integer | null
enable_auto_sync
boolean | null
presigned_url
string | null
parsed_text_url
string | null
additional_presigned_urls
object | null
source_created_at
string | null
generate_sparse_vectors
boolean | null
request_id
string | null
upload_id
string | null
sync_properties
object
messages_metadata
object
file_contents_deleted
boolean
default: false
hot_storage_time_to_live
integer | null