Skill versions
Take a marketplace update
Bring the marketplace’s newer version into your copy, merged onto your own changes.
POST
Take a marketplace update
Your copy gets the changes made to the original since you copied it. Changes you made yourself are kept, and
kept_yours lists them. The result is saved as a new version, so you can restore the one before.
If you and the author changed the same step in different ways, nothing is applied. The update is saved as version candidate_version, unapplied. Compare it and restore it if you want it.
Owner or workspace editor. Needs skills:write. MCP tool: update_from_marketplace with apply: true.Authorizations
API key with the vd_sk_ prefix, as Authorization: Bearer vd_sk_.... Create keys in Settings → API Keys.
Headers
Any unique string (such as your order id). Resending the same request with the same key within 24 hours returns the first answer (with Idempotent-Replayed: true) and does nothing twice; the same key with a different request is a 422 idempotency_key_reused.
Required string length:
1 - 255Path Parameters
Response
Successful Response
Your skill's new live version
On a conflict: the version the update was saved as, unapplied
Recipe parts you changed, kept as yours

