Skip to content
SupaCloud Docs
Select themeSelect language

`POST /api/marketplace/publish` — publish a workspace App to the marketplace as a buildable source listing (ADR 0030 UX3-D). Workspace-admin only: a publish creates a public listing, so it mirrors the source-mutation auth.

POST
/api/marketplace/publish
curl --request POST \
  --url https://example.com/api/marketplace/publish \
  --header 'Content-Type: application/json' \
  --data '{ "app_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "pricing": { "amount_minor": 1, "currency": "example", "model": "example" }, "slug": "example", "summary": "example", "version": "example" }'

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
app_id
required
string format: uuid
pricing
One of:
null
slug
string | null
summary
string | null
version
string | null
Examplegenerated
{
  "app_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "pricing": {
    "amount_minor": 1,
    "currency": "example",
    "model": "example"
  },
  "slug": "example",
  "summary": "example",
  "version": "example"
}

Responses

Section titled “Responses”

200

Section titled “200”
Media typeapplication/json

What a successful publish returns to the seller UI.

object
expected_storage_mb
required
integer format: int32
framework
required
string
item_id
required
string format: uuid
slug
required
string
source_id
required
string format: uuid
source_tarball_sha256
required
string
version
required
string
version_id
required
string format: uuid
Examplegenerated
{
  "expected_storage_mb": 1,
  "framework": "example",
  "item_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "slug": "example",
  "source_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "source_tarball_sha256": "example",
  "version": "example",
  "version_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}