Request to publish a marketplace demo
Submit a publish request for review. Requires justification. Optional allowed_orgs_request_text describes who should receive access if the outcome is not fully public. Optional tags assigns tag names to the demo before queuing the request (same rules as demo PATCH; omit to leave tags unchanged). Optional publisher sets the publisher on the demo before queuing the request (omit to leave the existing publisher unchanged). name, description, and documentation must already be set. tags and publisher must be set, either previously or in this request, before the demo can be queued for publishing. Set publish_images to true to automatically publish referenced images that are not yet visible to the demo’s target audience. Returns 400 when referenced images need publishing and publish_images is false. Returns 409 when another visibility or publish change is already pending.
Required scopes (any one):
air:marketplace_demo_write(roles:air_demo_manager,air_org_admin,air_user)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
When true, the requester prefers a public publish. When false, the requester prefers a restricted-access publish; describe the desired allow list in allowed_orgs_request_text.
Optional publisher name to set on the demo when submitting the publish request (e.g. NVIDIA, Google). Omitting the field leaves the existing publisher unchanged. A publisher must be set, either previously or in this request, before the demo can be queued for publishing.
Optional free-text description of orgs that should have access if the outcome is restricted. Not the authoritative allow list.
When true, queue image publish requests for org-owned images referenced by the demo that are not yet visible to the demo’s target audience. When false (default), the request is rejected with 400 if any such image needs publishing.
When true, list the restricted demo for all authenticated users while provisioning stays allow-list gated. Only accepted when publishing as restricted (not public).
Response
E-mail of the creator of the marketplace demo.
If the marketplace demo is owned by the client. When true, the client can publish or unpublish the demo.
Whether the marketplace demo is visible to the entire catalog (true only when the demo is in the published catalog AND its publish access record is set to public).
Whether the marketplace demo is listed for all authenticated users while provisioning stays allow-list gated. True only when the demo is in the published catalog and its publish access record has preview enabled.
Status of the caller’s organization’s access request for this demo, if any (REQUESTED, GRANTED, DENIED, REVOKED, CLOSED). Null when the organization has not requested access.
The id of the marketplace demo publish access record. Returned only to the owning organization, Air admins, and SREs; null otherwise.
Number of times a clone has been provisioned from this marketplace demo (counted when the provision request creates the clone; not decremented if that clone later fails to boot).
The state of the simulation instance associated with this demo which acts as the template for all provisioned simulations from this demo. If the demo was successfully created, this value will be DEMO or CLONING.
The name of the company or organization the marketplace demo is published under (e.g. NVIDIA, Google). Required before a marketplace demo can be published.
Public URL of the marketplace demo icon stored in the publicly-accessible bucket. Legacy rows may still contain raw icon data in data URL format until the icon is next updated.