External

Create public buy request via API key

post/v1/external/buy_requests

Request

  • Base URL: http://localhost:8000
  • URL: http://localhost:8000/v1/external/buy_requests
  • Auth: none declared

Headers

X-API-Keystring nullable

Request body

namestring required

Short, scannable headline for the buy request — what you're looking for. Sales-oriented language: a supplier reads this first and decides whether to keep reading. Required.

descriptionstring nullable

Markdown-friendly long-form description of the request. Specs, constraints, why generic alternatives won't do, preferred delivery method — anything a supplier would need to decide whether they can fulfil this.

quantityinteger

How many units the poster wants.

currencystring nullable
contactstring nullable

Free-form contact info (email/phone/Telegram handle/whatever) shown publicly on the buy request so suppliers can reach the poster. No format enforced. Partle doesn't broker the message.

reference_urlstring nullable

Optional link to a sample, datasheet, manufacturer page, or any reference image of the desired item.

product_idinteger nullable

Optional link to a canonical Partle product if the poster is asking for one specific known SKU. For custom or freeform asks, leave null.

Response

Successful Response

idinteger required
user_idinteger required
namestring required
descriptionstring nullable
quantityinteger required
max_pricestring nullable
currencystring nullable
contactstring nullable
reference_urlstring nullable
product_idinteger nullable
created_atstring date-time required
updated_atstring date-time required
closed_atstring date-time nullable

Changes

No recorded changes to this operation across all 1 revision of this API.