Get a presigned S3 URL for direct file upload

POST

https://api.smallest.ai/atoms/v1/knowledgebase/get-presigned-url

POST

/atoms/v1/knowledgebase/get-presigned-url

1 import requests
2 
3 url = "https://api.smallest.ai/atoms/v1/knowledgebase/get-presigned-url"
4 
5 payload = {
6     "fileName": "marketing-presentation.pptx",
7     "fileSize": 5242880,
8     "contentType": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
9     "knowledgeBaseId": "5f8d04b3a1c2e45b6d7f9a12"
10 }
11 headers = {
12     "Authorization": "Bearer <token>",
13     "Content-Type": "application/json"
14 }
15 
16 response = requests.post(url, json=payload, headers=headers)
17 
18 print(response.json())

1 {
2   "status": true,
3   "data": {
4     "url": "https://s3.amazonaws.com/atoms-uploads/5f8d04b3a1c2e45b6d7f9a12/marketing-presentation.pptx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20240601%2Fus-east-1%2Fs3%2Faws4_",
5     "key": "uploads/5f8d04b3a1c2e45b6d7f9a12/marketing-presentation.pptx"
6   }
7 }

Two-step file upload flow that bypasses Atoms’ API for the file bytes themselves — useful when files exceed the multipart upload limit on POST /knowledgebase/{id}/items/upload-media or when you want to upload from the browser without round-tripping through your backend.

Step 1: Call this endpoint with file metadata. Atoms returns a presigned URL + a storage key. Step 2: PUT the file bytes directly to the presigned URL (set Content-Type to the same value you sent here). Step 3: Call POST /knowledgebase/compelete-file-upload with the same key to commit the upload and start processing.

Same end result as POST /knowledgebase/{id}/items/upload-media, just without the multipart-through-our-API hop.

Two-step file upload flow that bypasses Atoms' API for the file bytes themselves — useful when files exceed the multipart upload limit on `POST /knowledgebase/{id}/items/upload-media` or when you want to upload from the browser without round-tripping through your backend. **Step 1**: Call this endpoint with file metadata. Atoms returns a presigned URL + a storage `key`. **Step 2**: `PUT` the file bytes directly to the presigned URL (set `Content-Type` to the same value you sent here). **Step 3**: Call [`POST /knowledgebase/compelete-file-upload`](#operation/completeKnowledgeBaseFileUpload) with the same `key` to commit the upload and start processing. Same end result as `POST /knowledgebase/{id}/items/upload-media`, just without the multipart-through-our-API hop.

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Request

This endpoint expects an object.

fileNamestringRequired

Original filename — used for display in the Atoms dashboard. Doesn’t have to match the S3 key.

fileSizeintegerRequired>=1

Size in bytes. Atoms uses this to enforce per-file limits before issuing the URL.

contentTypestringRequired

MIME type. You must send this EXACT value as Content-Type on the subsequent PUT to the presigned URL.

knowledgeBaseIdstringRequired

24-char hex ObjectId of the target knowledge base (from GET /knowledgebase).

Response

Presigned URL ready — upload directly to it.

statusboolean

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error