Media API

Upload, list, and serve trace artifacts. obsrv proxies all media so the browser and your services never need direct object-storage credentials.

POST /v1/media/upload

Multipart upload for image, audio, video, sensor, and generic file artifacts.

curl -X POST https://api.obsrv.tech/v1/media/upload \
  -H "x-api-key: $THETA_API_KEY" \
  -F "trace_id=tr_…" \
  -F "step_id=st_…" \
  -F "kind=image" \
  -F "file=@./screenshot.png"

GET /v1/media/serve

Browser-safe streaming endpoint. Pass the URI returned by the upload call.

GET /v1/media/serve?uri=gs%3A%2F%2Fobsrv-prod%2F…
x-api-key: tk_live_…

GET /v1/media/signed-url

Mints a short-lived signed PUT URL for direct uploads from a trusted backend. Not exposed to browsers.

← Steps

Metrics →