Skip to main content
PATCH
Change demand-check settings

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
check_frequency
enum<string>
Available options:
adaptive,
weekly,
monthly,
never
check_channels
enum<string>
Available options:
agent_then_email,
agent_only,
email_only
deal_alerts
boolean

Response

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

check_frequency
enum<string>
required
Available options:
adaptive,
weekly,
monthly,
never
check_channels
enum<string>
required
Available options:
agent_then_email,
agent_only,
email_only
deal_alerts
boolean
required
request_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)$
message
string

What to tell the person.

agent_line
string

What the agent does next.