Skip to main content
POST
Decline an opportunity

Authorizations

Authorization
string
header
required

An API key from your dashboard, sent as Authorization: Bearer gpk_….

Headers

Idempotency-Key
string
required

Unique per intent. Retries of the same intent must reuse it verbatim; a new intent needs a new one. Remembered for 24 hours.

Required string length: 1 - 255
Pattern: ^[\x20-\x7E]+$

Path Parameters

id
string
required

Response

The opportunity, now declined

id
string
required
status
enum<string>
required

offered is the only state that still waits for you.

Available options:
offered,
accepted,
declined,
expired,
withdrawn
listingId
string
required

Your listing the demand was matched to

demand
object
required

The anonymised specification — a request without its author and without notes.

offeredAt
string<date-time>
required
decidedAt
string<date-time> | null
required