Publish a marketplace demo
Immediately publishes the marketplace demo. Default prefer_public is true (globally visible). When prefer_public is false, send authoritative allowed_orgs as a UUID array for the restricted allow-list (distinct from gated request-publish string hints). Optional justification is stored for audit when provided. Set publish_images to true to publish org-owned images referenced by the demo so they reach the demo audience. Returns 400 when the demo is already published, has a pending first-publish request, when any referenced image needs publishing to reach the demo audience and publish_images is false, or when an image owned by another organization is not yet visible to the demo’s target audience. name, description, tags, documentation, and publisher must be set on the marketplace demo before it can be published.
Required scopes (any one):
air:marketplace_demo_publish(roles:air_demo_manager)
Additional permissions:
- Only members of the owning organization, Air admins, or SREs may perform this action on this marketplace demo.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
Request
Whether to publish as public (true, default) or restricted (false). When false, supply the authoritative allowed_orgs.
Authoritative allow-list: orgs that may use the demo when prefer_public is false. The demo owning org is always included; [] is valid. Privileged endpoint only — not the gated request-publish string hint.
Optional text explaining who/why to share with.
When true, automatically publish org-owned images referenced by the demo so they reach the same audience as the demo. When false (default), the request is rejected with 400 if any referenced image needs to be published to reach the demo audience.