Prepare a direct file upload

Requires project membership and OAuth scene:write when using OAuth. Returns a short-lived signedUrl; PUT raw bytes there with the supplied Content-Type, then complete at this endpoint with PUT. The file is listed only after completion. Maximum 500 MiB; SVG is refused. Names contain no path separators or control characters.

post/api/projects/{id}/files/uploads

Request

  • Base URL: https://editor.pascal.app
  • URL: https://editor.pascal.app/api/projects/{id}/files/uploads
  • Auth: HTTP bearer

Request body

namestring required
mimeTypestring required
sizeinteger required
type'scan' | 'guide' | 'image' | 'document' | 'other'
source'editor' | 'ai_chat' | 'api' | 'import'

Response

Upload destination; retain id and storageKey for completion retries

idstring required
storageKeystring required
signedUrlstring uri required

Changes

No recorded changes to this operation across all 1 revision of this API.