Sign in
Shops

Create shop

Changed on

Create a new shop. If contractor_id is provided, the shop is org-owned (user must have manage_market). Otherwise, user-owned.

post/shops

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
  • Auth: loggedin (a scheme the document does not define)

Request body

namestring required
slugstring
descriptionstring
bannerstring
logostring
contractor_idstring

If set, shop is owned by this org. User must have manage_market in the org.

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