Sign in
Shops

Update shop

Changed on

Update shop settings. Only the shop owner (or org member with manage_market) can update.

put/shops/{shopId}

Request

  • Base URL: /api/v2 (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v2/shops/{shopId}
  • Auth: loggedin (a scheme the document does not define)

Path parameters

shopIdstring required

Request body

namestring
slugstring
descriptionstring
bannerstring
logostring
supported_languagesstring[]
market_order_templatestring
default_pickup_methodstring nullable
tagsstring[]
accepts_custom_ordersboolean
official_server_idstring nullable

Discord server (guild) ID where order/offer threads are created for this shop

discord_thread_channel_idstring nullable

Discord channel ID under which order/offer threads are created for this shop

Response

Ok

shop_idstring required
slugstring required
namestring required
descriptionstring required
bannerstring nullable required
logostring nullable required
owner_user_idstring nullable required
is_org_ownedboolean required
owner_contractor_spectrum_idstring nullable required

Spectrum ID of the owning contractor (for V1 APIs that need it)

supported_languagesstring[] required
tagsstring[] required
accepts_custom_ordersboolean required
market_order_templatestring required
default_pickup_methodstring nullable required
statusstring required
created_atstring required
updated_atstring required
banner_urlstring nullable required
official_server_idstring nullable required

Discord server (guild) ID where order/offer threads are created for this shop

discord_thread_channel_idstring nullable required

Discord channel ID under which order/offer threads are created for this shop

badge_idsstring[] required

Seller reputation badges, computed server-side from shop metrics + owner data

logo_urlstring nullable required

Changes

  • 1ae533d4df37Revision changes
    • ○

      added the new optional request property

    • ○

      added the new optional request property

    • ○

      added the required property to the response with the status

    • ○

      added the required property to the response with the status

  • e0cd5d2dfa78Revision changes
    • ○

      added the required property to the response with the status