Skip to content
KolonyKolonyKolony Docs

Publish, approve, fetch

Goal

Section titled “Goal”

Create a published asset on a space, upload bytes, list items awaiting approval, and download by opaque id.

Steps

Section titled “Steps”
  1. Authenticate and obtain a spaceId
  2. POST /v0/spaces/{spaceId}/assets — metadata only; capture newPublishedAssetId
    Subject to spaces.publishedAssets.perDay
  3. POST /v0/media/spaces/{spaceId}/assets/{assetId} — multipart field file
  4. Owner review: GET /v0/spaces/{spaceId}/assets/awaiting-approval (part descriptors only; no storage paths)
  5. PATCH /v0/spaces/{spaceId}/assets — update asset state as exposed in OpenAPI
  6. GET /v0/media/spaces/{spaceId}/assets/{assetId}?part=base — stream bytes

After the asset is approved or enabled, AI analyses the file (identifying tags on images and video; English transcriptions on video and audio). You do not call /v0/ai to trigger that. See AI.

Details: Media uploads. Limits: Errors & limits.