Prepares a marketplace listing deploy: validates the plan against the listing's requirements and the seed v...
POST/marketplace/listings/:listingId/deploy/prepare
Prepares a marketplace listing deploy: validates the plan against the listing's requirements and the seed values against its seed-field schema, resolves the listing's default published version to an image, renders the cloud-init user-data server-side, claims a deployment (idempotencyKey), and returns the standard buy+build params, the secret seed key/value pairs to write to your secret list, and the deployment id. The caller then writes the secrets and places the order through the platform's standard session-authenticated buy+build, and calls the record endpoint on success. vapi3 itself never calls buy+build or /secrets. Retrying with the same idempotencyKey re-uses the existing deployment (and, once its instance is recorded, returns it without preparing another order).
Request
Responses
- 200
- 204
- 400
- 403
An OK response
When you do a PATCH request, this indicates no actual were applied because the values you requested would not change anything.
A response provided when the request is invalid.
A response provided when the request is not authenticated.