trajectories

Upload Figure Blob

Upload a figure straight into the PRIVATE omicos-drive bucket (State 2).

multipart form:

  • file: the COMPRESSED figure (served inline via presign)
  • original: optional full-res original (for tap-to-zoom / download)
  • canonical_path: the local figure path core keeps embedding (provenance)
  • mime, compressed: metadata for the figure_url_map row

The blobs are content-addressed by sha256 and recorded in user_blob_refs (the same table the GC janitor + storage quota key off), and a figure_url_map row is upserted so serve-time rewrite can mint a presigned GET. Owner-only (same write gate as /append). 503 when the private drive is unconfigured (State 2 inert), 413 when the user is over quota.

post/api/trajectories/{session_id}/figures/upload

Request

  • Base URL: https://api.omicos.cn (the document declares no server; this is the origin it was published from)
  • URL: https://api.omicos.cn/api/trajectories/{session_id}/figures/upload
  • Auth: none declared

Path parameters

session_idstring required

Headers

authorizationstring nullable

Request body multipart/form-data

filestring binary required
originalstring binary nullable
canonical_pathstring required
mimestring nullable
compressedboolean

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 20 revisions of this API.