Skip to main content
PATCH
/
api
/
marketplace
/
{id}
Update publish settings for a marketplace item
curl --request PATCH \
  --url https://your-instance.example.com/api/marketplace/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "shareType": "reference",
  "isContentVisible": true,
  "allowEditableReferences": true
}
'
{
  "success": true,
  "data": {
    "marketplaceItem": {
      "_id": "64d2f9c5e8a1d4e001a0b1c2",
      "itemType": "prompt",
      "itemId": "64a1b2c3d4e5f6001234567a",
      "publishedBy": "64a1b2c3d4e5f60012345679",
      "scope": "marketplace",
      "shareType": "reference",
      "allowEditableReferences": false,
      "isContentVisible": true,
      "name": "Maple Court — Tour Confirm",
      "status": "active",
      "usageCount": 12
    }
  }
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string
required

Body

application/json
​
shareType
enum<string>

reference (acquirer gets a live link) or copy (acquirer gets an editable duplicate).

Available options:
reference,
copy
​
isContentVisible
boolean

When false, marketplace browsers see metadata only — body is hidden until acquired.

​
allowEditableReferences
boolean

For reference listings on organization scope, allow acquirers to edit the linked item; only applied when shareType stays reference.

Response

Publish settings updated

Returned after a publish-settings PATCH. Wraps the updated marketplace item.

​
success
enum<boolean>
required
Available options:
true
​
data
object
required