POST /api/v1/uploads/sessions – Falconer Public API

post/api/v1/uploads/sessions

Request

Base URL: https://falconer.com (the document declares no server; this is the origin it was published from)
URL: https://falconer.com/api/v1/uploads/sessions
Auth: none declared

x-organization-idstring

Required when using OAuth bearer tokens.

filenamestring required

Filename, including extension

sizeinteger required

File size in bytes

mimeTypestring

File MIME type

kind'auto' | 'image' | 'video' | 'file'

Upload kind. Defaults to auto. Files such as PDF, Office, text and code attachments are kind "file".

altstring

Alt text for images.

Upload session. PUT the raw file bytes to uploadUrl with the given headers, then complete the session.

uploadTokenstring required

Opaque token to pass to the complete call after uploading.

uploadUrlstring required

Short-lived URL to send the raw file bytes to. Never persist it.

method'PUT' required

headersobject required

Headers the upload request must send exactly as given.

expiresAtstring required

When uploadUrl stops accepting the file (ISO 8601).

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