> For the complete documentation index, see [llms.txt](https://docs.ibexa.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ibexa.ai/developers/rest-api/files/upload-file.md).

# Upload File

Upload a file and attach it to a conversation.

```json
{"openapi":"3.1.0","info":{"title":"Ibexa Agentic Marketing Platform","version":"0.1.0"},"security":[{"OAuth2PasswordBearer":[]}],"components":{"securitySchemes":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"/api/v1/login/access-token"}}}},"schemas":{"Body_files-upload_file":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_files-upload_file"},"FileResponseSchema":{"properties":{"uuid":{"type":"string","format":"uuid","title":"Uuid"},"organisation_id":{"type":"integer","title":"Organisation Id"},"conversation_id":{"type":"integer","title":"Conversation Id"},"original_filename":{"type":"string","title":"Original Filename"},"content_type":{"type":"string","title":"Content Type"},"file_size":{"type":"integer","title":"File Size"},"created_by":{"type":"string","format":"uuid","title":"Created By"},"message_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Message Id"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["uuid","organisation_id","conversation_id","original_filename","content_type","file_size","created_by"],"title":"FileResponseSchema","description":"Pydantic schema for uploaded file response."}}},"paths":{"/api/v1/conversations/{conversation_id}/files/":{"post":{"tags":["files","public"],"summary":"Upload File","description":"Upload a file and attach it to a conversation.","operationId":"files-upload_file","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"integer","title":"Conversation Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_files-upload_file"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileResponseSchema"}}}},"401":{"description":"User not authenticated","content":{"application/json":{}}},"403":{"description":"User lacks permission","content":{"application/json":{}}},"404":{"description":"Resource not found or user has no permission to access it","content":{"application/json":{}}},"413":{"description":"File exceeds maximum allowed size","content":{"application/json":{}}}}}}}}
```