Files and images
Send images and documents with your messages, by URL or by uploading them first.
Base URLhttps://api.kalle.build/v1AuthBearer kalle_sk_…VersionKalle-Version: 2026-11-01
Upload a file
Upload once and refer to the file by its ID in as many messages as you like. Files are stored until you delete them and are only visible to your workspace.
| Type | Formats | Max size |
|---|---|---|
| Images | JPEG, PNG, WebP, GIF | 10 MB |
| Documents | PDF, plain text, Markdown, CSV | 32 MB |
POST/v1/files
curl https://api.kalle.build/v1/files \
-H "Authorization: Bearer $KALLE_API_KEY" \
-H "Kalle-Version: 2026-11-01" \
-F "file=@menu.pdf" \
-F "purpose=user_data"Use files in a message
Content blocks
"content": [
{ "type": "document", "source": { "type": "file", "file_id": "file_9Kd2" } },
{ "type": "image", "source": { "type": "url", "url": "https://example.com/studio.jpg" } },
{ "type": "text", "text": "Make a price list from the menu, in the style of the photo." }
]Delete a file
Deleted files can no longer be used in new messages.
DELETE/v1/files/file_9Kd2
curl https://api.kalle.build/v1/files/file_9Kd2 \
-X DELETE \
-H "Authorization: Bearer $KALLE_API_KEY" \
-H "Kalle-Version: 2026-11-01"