Skip to main content
POST
Respond to a demand signal

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

storefrontId
integer
required
Required range: 1 <= x <= 9007199254740991
signalId
integer
required
Required range: 1 <= x <= 9007199254740991

Body

application/json
kind
enum<string>
required
Available options:
QUOTE
payload
object
required

Response

Respond to a demand signal

A seller action against a demand_signal_target.

id
string
required
demandSignalId
string
required
demandSignalTargetId
string
required
sellerCustomerId
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
storefrontId
string | null
required
kind
enum<string>
required
Available options:
QUOTE,
CLARIFY,
DECLINE,
BOOK
payload
object | null
required
matchScore
integer | null
required
Required range: 0 <= x <= 100
actorUserId
integer | null
required
Required range: -9007199254740991 <= x <= 9007199254740991
createdAt
string
required
proposalCode
string | null

Storefront proposal code (e.g. "PRP-XK4A29") minted alongside a QUOTE so the buyer's agent can redeem the offer via discover_products. Null when the seller declined, or when operator resolution failed at QUOTE time.