Uploading documents
Uploaded documents are indexed into the knowledge base immediately, without an approval step. You can upload from the artifacts list or attach files directly in Atlas chat.

Upload from the artifacts list
Open Artifacts in the project sidebar and press Upload. The Upload Document modal opens. Drag a file into the drop zone or click to browse, add an optional title, and press Upload. The document appears in the artifact list and is available in the knowledge base.
Attach in Atlas chat
Attach a file directly in the Atlas chat input. Each attachment is ingested through the same path as a manual upload.
Accepted formats
Uploads fall into two categories based on extension.
Text formats (.md, .txt, .csv) are stored inline as artifact content and indexed for both search and RAG immediately. No background processing is required.
Binary formats (.pdf, .docx, .xlsx, .pptx, .png, .jpg, .jpeg, .svg) are saved to disk and sent to a background worker for parsing and embedding. Images are processed through a captioning step so their content becomes searchable.
Audio and video files (.mp3, .wav, .mp4, .mov, and similar) are not supported. Uploading one sets the normalization status to unsupported and the file is not indexed.
Normalization status
Each uploaded document carries a normalization status that reflects where it is in the ingestion pipeline.
Batch upload
The API supports uploading multiple files in one call via POST /projects/{id}/documents/batch. Each file in the batch is processed independently and returns its own status.