Appearance

Marketplace ​

Withdraw a marketplace listing​

DELETE
/v1/marketplace/listings/{listing_id}

Retires a listing so it stops appearing in browse. Withdrawable by whoever listed it, and by EchoMode staff acting as platform moderators — NOT by the publishing organization's own admin, since a colleague's listing is theirs to retract. Organizations that already imported it keep their copy: an import is an independent row, not a reference. Withdrawing twice is not an error, and a listing the caller may not withdraw is reported as missing rather than forbidden, so the endpoint cannot be used to probe for other people's listings.

Authorizations​

HTTPBearer
Type
HTTP (bearer)

Parameters​

Path Parameters

listing_id*
Type
string
Required
Format
"uuid"

Responses​

Successful Response

application/json
JSON
{
  
"listingId": "string",
  
"message": "string",
  
"withdrawn": true
}

Samples​

Import a listing into your organization​

POST
/v1/marketplace/listings/{listing_id}/import

Copies the listing into your organization as a published copy you own, and returns the copy's id. It is a copy, not a reference: the publisher cannot change it, withdrawing the listing does not affect it, and any inference it runs bills your organization. You hold at most one copy per listing: importing again while your copy exists returns 409, as does importing a withdrawn listing or a listing of your own build.

Authorizations​

HTTPBearer
Type
HTTP (bearer)

Parameters​

Path Parameters

listing_id*
Type
string
Required
Format
"uuid"

Responses​

Successful Response

application/json
JSON
{
  
"agentSurface": "string",
  
"copyId": "string",
  
"importedAgentCount": 0,
  
"kind": "string",
  
"listingId": "string",
  
"message": "Imported. This copy is yours; the publisher cannot change it."
}

Samples​