Skip to main content
POST
Answer a question

Authorizations

Authorization
string
header
required

An OAuth access token for the buyer resource (audience, issuer and signature checked). Its scopes and the active grant the person approved are both enforced.

Headers

Idempotency-Key
string
required

Stable key for one logical write. 8–64 characters. Reusing it with different input returns 409.

Required string length: 8 - 64
API-Version
string
default:2026-11-20

Current contract only; no version negotiation. See https://docs.populardemand.market/api-reference/introduction.

Path Parameters

id
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Body

application/json
question_id
required

The question’s id from get_request, or still_want.

Allowed value: "still_want"
answer
object
required

choice: one of the question’s choices (yes or pause for still_want). text: the number (money_minor: cents for USD). null: the person doesn’t know.

Response

Private result; no-store/noindex. No payment or executable order is implied.

request_id
string
required
question_id
string
required
recorded
boolean
required
effect
string | null
required
next_step
string | null
required
message
string

What to tell the person.

agent_line
string

What the agent does next.

{key}
any