Files API

Files represent uploaded evidence such as vehicle damage photos and EDR (Event Data Recorder) files. Files are associated with cases and used for crash analysis.

Endpoints

Method	Endpoint	Description
POST	/api/files/upload	Upload file
GET	/api/files	List files
GET	/api/files/:fileId	Get file
DELETE	/api/files/:fileId	Delete file

File Object

{
  "fileId": "file_abc123def456",
  "fileName": "front_damage.jpg",
  "status": "ready",
  "downloadUrl": "https://api.silentwitness.ai/api/files/file_abc123/download",
  "url": "https://storage.silentwitness.ai/..."
}

Supported File Types

Vehicle Damage Photos

• Formats: JPG, JPEG, PNG, HEIC, HEIF
• Max size: 50MB per file
• Quantity: 1-20 photos per vehicle

EDR (Event Data Recorder) Files

• Formats: PDF, CDR
• Max size: 50MB per file
• Quantity: 1 file per vehicle

File Categories

When uploading files, specify the category:

Category	Description
crash_analysis_plaintiff	Plaintiff vehicle photos
crash_analysis_defendant	Defendant vehicle photos
research_scrutinizer_plaintiff	Research documents (plaintiff)
research_scrutinizer_defense	Research documents (defense)

File Status

Status	Description
processing	File is being uploaded
ready	File is ready for use
error	Upload failed

Workflow

1. Create a case first
2. Upload files with case ID
3. Files are automatically linked to the case
4. Use files in crash analysis and report generation

Next Steps

• Upload a File
• Create a Case (required before uploading)