Skip to main content
Upload a new file to the system for use in knowledge bases.

​
Request Body

​
file
file
required
The file to upload
​
tags
array
Optional tags for organizing the file
curl -X POST https://api-be.atthene.com/api/v1/files/ \
  -H "x-api-key: YOUR_API_KEY" \
  -F "file=@/path/to/document.pdf" \
  -F "tags=manual,product"

​
Response

{
  "id": "file_456",
  "original_filename": "document.pdf",
  "file_type": "document",
  "size_bytes": 2048576,
  "status": "uploading",
  "tags": ["manual", "product"],
  "created_at": "2025-01-15T10:30:00Z"
}
Files start with status “uploading” and transition to “active” once processing is complete.