Publish a marketplace demo

PATCH

https://api.dsx-air.nvidia.com/api/v3/marketplace/demos/:id/publish/

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.

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

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequiredformat: "uuid"

A UUID string identifying this marketplace demo.

Request

This endpoint expects an object.

prefer_publicbooleanOptionalDefaults to true

Whether to publish as public (true, default) or restricted (false). When false, supply the authoritative allowed_orgs.

allowed_orgslist of stringsOptional

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.

justificationstringOptional<=2048 charactersDefaults to

Optional text explaining who/why to share with.

publish_imagesbooleanOptionalDefaults to false

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.

Response

No response body

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

500

Internal Server Error