Store an asset

Persist a file to Runtype asset storage and return its descriptor (id, servable URL, content type, size). Provide EXACTLY ONE of `content` (base64-encoded inline bytes) or `url` (a source the server downloads with SSRF protection and a 25 MB cap). Public assets get a permanent public URL; private assets get a 1-hour HMAC-signed URL. Tenant identity is taken from the authenticated caller — identity fields in the body are rejected. Also reachable at POST /v1/runtime/assets (the runtime-family contract consumed by `@runtypelabs/runtime`'s HostedAssetStore).

Authentication

AuthorizationBearer
API key or Clerk session token

Request

This endpoint expects an object.
objectRequired
OR
objectRequired

Response

The stored-asset descriptor

assetIdstring
contentTypestring
sizeBytesdouble
urlstring
visibilityenum
expiresIndouble
originalUrlstring

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
500
Internal Server Error
503
Service Unavailable Error