fulfillments

Acknowledge ALL matching Fulfillments

Mark the caller's read-receipt (type=seen, default) or the receiver paid attestation (type=paid) on EVERY live fulfillment matching the filter — no id list, no page cap — so "mark all seen" clears badges beyond the loaded page. Filter axes (direction / contact / created_after window / self_payments) mirror the per-contact unseen-count badge, so the ack clears exactly what the badge counts. Idempotent; returns the number newly acknowledged.

post/me/fulfillments/ack-all

Request

  • Base URL: https://api.instruxi.dev/api/v1/enforcer
  • URL: https://api.instruxi.dev/api/v1/enforcer/me/fulfillments/ack-all
  • Auth: API key in header Authorization

Request body

contactstring

scope to one counterparty (its account id)

created_afterstring

RFC3339 window floor (match the badge read's floor)

directionstring

"sent" | "received" | "" (all)

self_paymentsstring

include (default) | exclude | only

typestring

"seen" (default) | "paid"

Response

OK

successboolean

Example response

{
  "success": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.