Vendor-attested off-network transaction (vendor key auth)

Vendors report transactions that happened outside this network — direct agent-to-vendor over the UFP vendor binding, or any other channel — to earn reputation credit and feed demand-gap routing. Auth is a vendor attestation key (ufp_vk_…), never an agent key; vendor identity comes from the key, a vendor_id in the payload is ignored. Idempotent on attestation_id: resubmitting updates (quoted_only → fulfilled). Credit is a ladder: bare attestation = partial, always labeled attested_transaction; evidence makes it spot-checkable; buyer confirmation = full (an unverified token never earns full). Full doc: /docs/attestations.md.

post/v1/attestations

Request

  • Base URL: https://agenticfabricationnetwork.ai
  • URL: https://agenticfabricationnetwork.ai/v1/attestations
  • Auth: HTTP bearer

Request body

attestation_idstring required

Vendor-generated idempotency key — resubmitting the same id updates the attestation (quoted_only → fulfilled), never duplicates

ufp_versionstring required
outcome'quoted_only' | 'ordered' | 'fulfilled' | 'cancelled' | 'refunded' | 'lost_capability_gap' required
occurred_atstring date-time required
fulfilled_atstring date-time
evidenceobject

Evidence bundle — mandatory when available, never necessitated: tracking (or a declared-untracked marker), request/offer/file payload hashes, result photos, invoice_ref, delivered_at, buyer_hash (HMAC — no PII), buyer_confirmation_token

Example request

{
  "ufp_version": "0.3.0"
}

Response

Attestation receipt — graded credit plus a detail string saying exactly what would have earned more

attestation_idstring
status'accepted' | 'pending_buyer_confirmation' | 'rejected'
reputation_credit'none' | 'partial' | 'full'
detailstring

The feedback loop: exactly what would have earned more credit

Changes

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