media API (develop:84871a)

Returns the document identified by the given ID.

Creates a new document for the given owner from a media ID, with name, type, and showInPortal flag. Returns the created document.

Returns the documents matching the given document IDs.

Merges the given media items into a single file with the provided mergeMediumName. Returns the merged media as bytes.

Updates an existing document by ID with name, type, and showInPortal flag.

Adds a new version to the document identified by ID, linking the given media ID. Returns the updated document.

Removes the specified version from the document identified by ID. Returns the updated document.

Legacy sync Express multipart/form-data upload (not a gRPC method). Scans then stores and returns READY media immediately. Prefer CreateUpload for larger files (signed GCS PUT); both paths are always allowed.

The request body must be multipart/form-data with a single file field named file (plus optional form fields below). On success, returns the created media object as JSON (same fields as Media, status READY).

MIME type is detected from file content when possible. Blocked types (e.g. executables) return 403. Infected files (ClamAV) return 409. Missing file or invalid multipart return 400.

Example:

curl --location 'https://staging.myprop.ch/web/media' \
  --form 'public="false"' \
  --form 'file=@"/path/to/Vertrag.pdf"' \
  --form 'accountId=30001'

Start scan and promotion of quarantined file.Idempotent if already scanning or ready. Useful for local/dev without GCS notifications; also valid in production. Returns the current Media (may still be non-READY).

Creates a PENDING media row and returns a GCS V4 signed PUT URL (valid 15 minutes) to a quarantine bucket. After PUT, the object is scanned asynchronously (ClamAV); poll Get until status is READY, or call CompleteUpload to enqueue the scan (also used for local/dev without the GCS Pub/Sub bridge).

Prefer this path for larger files; the legacy Express Upload remains available for small/sync uploads. No server-enforced size split between the two paths.

url and thumbnails are empty until status is READY. Client mimeType is a hint only; the worker overwrites MIME from detected file content.

Returns the media items matching the given IDs. Items may be PENDING, SCANNING, REJECTED, or EXPIRED with empty url and thumbnails; usable URLs are only present when status is READY. Clients should poll or wait for media.uploaded after CreateUpload.

Sets the public flag on the media items with the given IDs according to the public value. Fails unless status is READY.

Returns the media item identified by the given ID, including filename, MIME type, size, URL, thumbnails, validity, and status. url and thumbnails are empty unless status is READY. After CreateUpload, poll until READY or wait for media.uploaded.

Deletes the media item identified by the given ID. May cancel a PENDING upload and remove the quarantine object.