Skip to main content
POST
Record a revision-notification decision on a sent PO

Authorizations

Authorization
string
header
required

API key issued per entity via Settings > Developers > API Keys. Each key carries scopes (e.g. orders:read, products:write). Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.

Headers

Idempotency-Key
string

Optional idempotency key for safe retries (Stripe-style).

Maximum string length: 255

Path Parameters

id
string<uuid>
required

Body

application/json
action
enum<string>
required

The operator's choice. skip records the dismissal and clears the amber banner without sending a revision email. (The send path is handled by POST /purchase-orders/{id}/send-to-vendor with template_key_override='po_revised'.)

Available options:
skip

Response

Revision-notification decision recorded.

skipped
boolean
revision_count
integer

The PO's current revision_count (now equal to last_notified_revision).