Delete a pending (draft) vendor return
Authorization: requires returns:write API-key scope AND the per-user
returns.process permission (SoD parity sweep 2026-05-16). System-actor calls denied.
Soft-deletes a vendor return in status: pending (draft). The row is preserved in the
database with status: deleted for audit purposes but is excluded from list views. Only
pending vendor returns may be deleted — use the cancel endpoint for shipped returns. No GL
entries are reversed because no accounting entries are posted until shipment.
Requires returns:write scope.
NEW-GAP-VENDOR-RETURN-CANCEL-DELETE-MISSING 2026-05-15.
Authorizations
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.
Path Parameters
Response
Vendor return deleted (soft)

