v1

latestOpenAPI 3.1.0MIT2026-07-173438118.7 KB
Files

Upload a file

Errors

Returns an error if file upload, database operations, or file system operations fail.

post/api/files/actions/upload

Response

File with same content already exists, returning existing file

messagestring required

Upload confirmation message

Example response

{
  "file": {
    "createdAt": "2023-01-01T00:00:00Z",
    "fileHash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "fileSize": 1048576,
    "filename": "document.pdf",
    "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "metadata": {
      "description": "Important document"
    },
    "mimeType": "application/pdf",
    "originalFilename": "My Important Document.pdf",
    "status": "uploaded",
    "updatedAt": "2023-01-01T00:00:00Z",
    "userId": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
  },
  "message": "File uploaded successfully"
}