Rendered event

Record that an existing native surface showed a returned offer.

Canonical paths are POST /v1/events/rendered and POST /v1/events/qualified-impression. POST /v1/events/impression remains an alias. Prefer the Idempotency-Key header.

Authentication

Bearer serving key required.

Request body

Field	Type	Required	Description
offer_snapshot_id	string (`snp_…`)	Yes	Snapshot id from `offer_id` on the decide response.
decision_id	string (`dec_…`)	No	Decision that returned the offer.
type	"offer_rendered" \| "qualified_impression"	No	Defaults to `offer_rendered` when omitted.
Idempotency-Key	header string (8–80)	Yes	Canonical retry key. Body idempotency_key remains accepted on the impression alias.

Send type: "offer_rendered" or omit type (default).

Request examples

curl -sS -X POST "https://knobase.com/v1/events/rendered" \
  -H "Authorization: Bearer $KNOBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"offer_snapshot_id":"snp_01EXAMPLEOFFER","decision_id":"dec_01","type":"offer_rendered","idempotency_key":"idemp_rendered_01"}'

Response

{
  "ok": true,
  "inserted": true,
  "event_id": "evt_01",
  "offer_snapshot_id": "snp_01EXAMPLEOFFER",
  "type": "offer_rendered",
  "billable": false
}

Errors

HTTP	error	When
401	auth errors	Missing or invalid serving key
400	invalid_event	Body failed validation
404	unknown_snapshot	offer_snapshot_id is unknown