Skip to main content
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

Authorization
string
header
required

API key with the vd_sk_ prefix, as Authorization: Bearer vd_sk_.... Create keys in Settings → API Keys.

Headers

Idempotency-Key
string

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 - 255

Path Parameters

slug
string
required

Response

Successful Response

skill_slug
string
required
applied
boolean
required
message
string
required
taken_version
integer | null
recipe_version
integer | null

Your skill's new live version

candidate_version
integer | null

On a conflict: the version the update was saved as, unapplied

kept_yours
string[]

Recipe parts you changed, kept as yours