Skill: Public Files

Description

Upload reference files (images, documents) for use in outline generation. This skill documents the public API at /api/v2/files (PublicApiFileController). Flow: 1) POST /prepare → get upload_url and s3_key; 2) PUT file to upload_url; 3) POST /confirm; use s3_key in file_s3_keys when calling slide-deck outline/generate. Authenticate with X-API-KEY header. Max 20 MB; allowed types: PDF, DOCX, PPTX, TXT, MD, PNG, JPEG, WebP, SVG, BMP, TIFF, HEIC, HEIF, AVIF, ICO.

TypeScript types (request / response)

Mirrors PublicApiFileController (/api/v2/files) data classes.

// --- Prepare (POST) ---
type PrepareFileUploadRequest = {
  file_name: string;   // max 255 chars
  mime_type: string;
  size: number;        // 1 to 20*1024*1024
};