File Management

Operations for uploading and managing project files

Upload multiple files to a project with enhanced support

post

Uploads one or more files to be associated with a project for research and content generation purposes.

Enhanced Features:

• Support for 20+ file types including PDF, Word, TXT, Markdown, Python, JSON, XML, CSV, HTML, TEX, JavaScript, C, YAML, TOML, and more

• Multi-file upload support (single or multiple files per request)

• Advanced validation with detailed error reporting

• Automatic duplicate detection and prevention

• Comprehensive response formatting with upload summary

• Secure file storage with unique naming and proper cleanup on errors

File Type Support: PDF, Word Documents, Text Files, Markdown, Python Scripts, JSON Data, XML Documents, CSV Files, HTML Files, TEX/LaTeX, JavaScript, C Source Code, YAML Configuration, TOML Configuration, Jupyter Notebooks, RSS/Atom Feeds, SVG Images, and more.

Upload Limits:

• Maximum file size: 50MB per file

• No limit on number of files per request

• Automatic validation and error reporting for each file

Authorizations

bearerAuth

AuthorizationstringRequired

JWT token for user session authentication.

Body

multipart/form-data

projectIdstring · uuidRequired

ID of the project to associate files with

Example: 123e4567-e89b-12d3-a456-426614174000

filesstring · binary[]Optional

Multiple files to upload (alternative to single file)

filestring · binaryOptional

Single file to upload (alternative to files array)

Responses

200

All files uploaded successfully

application/json

successbooleanOptionalExample: true

207

Multi-Status - Some files uploaded successfully, some failed

application/json

400

Bad Request - No files uploaded or all uploads failed

application/json

401

Unauthorized - Authentication required

application/json

404

Project not found or access denied

application/json

409

Conflict - File already exists

application/json

413

File too large - Exceeds 50MB limit

application/json

415

Unsupported file type

application/json

500

Internal Server Error

application/json

post

/uploadProjectFiles

HTTPcURLJavaScriptPython

POST /api/uploadProjectFiles HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 80

{
  "projectId": "123e4567-e89b-12d3-a456-426614174000",
  "file": "[binary file data]"
}

Upload a single fileUpload multiple files

{
  "success": true,
  "files": [
    {
      "id": "file-uuid-1",
      "file_name": "document.pdf",
      "file_type": "application/pdf",
      "file_size": 1048576,
      "file_url": "https://storage.example.com/files/document.pdf",
      "storage_path": "project-123/unique-id-1.pdf",
      "uploaded_at": "2024-01-15T10:30:00Z"
    }
  ],
  "summary": {
    "total_files": 1,
    "successful_uploads": 1,
    "failed_uploads": 0,
    "errors": []
  }
}

Get files associated with a project

get

Retrieves a list of all files uploaded to a specific project

Authorizations

bearerAuth

AuthorizationstringRequired

JWT token for user session authentication.

Query parameters

projectIdstring · uuidRequired

ID of the project to get files for

Responses

200

Project files retrieved successfully

application/json

Represents a file uploaded to a project

idstring · uuidRequired

The unique identifier for the file

project_idstring · uuidRequired

The ID of the project this file belongs to

file_namestringRequired

The original name of the uploaded file

Example: research_paper.pdf

file_sizenumberRequired

The size of the file in bytes

Example: 1048576

file_typestringRequired

The MIME type of the file

Example: application/pdf

storage_pathstringRequired

The path where the file is stored

created_atstring · date-timeRequired

When the file was uploaded

updated_atstring · date-timeRequired

When the file was last updated

400

Bad Request

application/json

401

Unauthorized

application/json

404

Project not found

application/json

500

Internal Server Error

application/json

get

/getProjectFiles

HTTPcURLJavaScriptPython

GET /api/getProjectFiles?projectId=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "project_id": "123e4567-e89b-12d3-a456-426614174000",
    "file_name": "research_paper.pdf",
    "file_size": 1048576,
    "file_type": "application/pdf",
    "storage_path": "text",
    "created_at": "2026-03-20T11:39:40.092Z",
    "updated_at": "2026-03-20T11:39:40.092Z"
  }
]

Delete a project file

delete

Removes a file from a project and deletes it from storage

Authorizations

apiKeybearerAuth

x-api-keystringRequired

API key for external service authentication.

Query parameters

fileIdstring · uuidRequired

ID of the file to delete

Responses

200

File deleted successfully

application/json

messagestringOptionalExample: File deleted successfully

400

Bad Request

application/json

401

Unauthorized

application/json

404

File not found

application/json

500

Internal Server Error

application/json

delete

/deleteProjectFile

HTTPcURLJavaScriptPython

DELETE /api/deleteProjectFile?fileId=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
x-api-key: YOUR_API_KEY
Accept: */*

{
  "message": "File deleted successfully"
}