Sign in
media

Upload Media

Upload a media file to a moment.

Supports images, videos, and audio. Files are validated and processed in background.

post/api/v1/media/upload

Request

  • The document declares no server URL.
  • Auth: OAuth 2 (password, token URL /api/v1/auth/token)

Cookies

access_tokenstring nullable

Response

Successful Response

created_atstring date-time required
updated_atstring date-time nullable
media_type'image' | 'video' | 'audio' | 'unknown' required

Media types for journal entries.

original_filenamestring nullable
file_sizeinteger nullable
mime_typestring required
durationnumber nullable
widthinteger nullable
heightinteger nullable
alt_textstring nullable
upload_status'pending' | 'processing' | 'completed' | 'failed'

Upload status for media files.

file_metadatastring nullable
idstring uuid required
checksumstring nullable
processing_errorstring nullable
waveform_peaksinteger[] nullable
signed_urlstring nullable
signed_thumbnail_urlstring nullable
signed_url_expires_atinteger nullable
signed_thumbnail_expires_atinteger nullable
moment_idstring uuid required

Changes