generated: '2026-08-26' method: generated source: openapi/optoro-asn-openapi.yml, openapi/optoro-auth-openapi.yml, openapi/optoro-catalogs-openapi.yml, openapi/optoro-disposition-update-openapi.yml, openapi/optoro-drop-ship-openapi.yml, openapi/optoro-drop-ship-webhooks-openapi.yml, openapi/optoro-exchange-orders-openapi.yml, openapi/optoro-external-bin-changes-openapi.yml, openapi/optoro-facilities-openapi.yml, openapi/optoro-final-disposition-openapi.yml, openapi/optoro-forward-orders-openapi.yml, openapi/optoro-inventory-receipt-openapi.yml, openapi/optoro-outbound-asn-openapi.yml, openapi/optoro-returns-portal-orders-openapi.yml, openapi/optoro-rmas-openapi.yml, openapi/optoro-rtv-openapi.yml, openapi/optoro-variants-openapi.yml description: Recommended x-agentic-access execution contracts, classified heuristically from the OpenAPI. A governance starting point for exposing this API to AI agents — review and bind audience per deployment. See research/curity/agentic-governance/. summary: operations: 32 by_action_class: acting: 23 connected: 9 by_consequence: write: 13 read: 9 physical: 10 human_in_the_loop_required: 0 operations: - path: /asns method: post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /asns/{asn-number} method: put x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /oauth/token method: post operationId: oauthTokenFetch x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /catalog_entry_updates method: post operationId: catalogEntryUpdate x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /dispositions method: post operationId: dispositions x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /listings method: get operationId: listingsIndex x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /listings/{id} method: get operationId: listingsShow x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /listings/{id} method: put operationId: listingsUpdate x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /orders method: get operationId: OrdersIndex x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /orders method: post operationId: ordersCreate x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /batch/orders method: post operationId: batchOrdersCreate x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /orders/{id} method: get operationId: ordersShow x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /orders/{id} method: put operationId: ordersUpdate x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /orders/{id} method: delete operationId: ordersCancel x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /shipments method: get operationId: shipmentsIndex x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /shipments/{id} method: get operationId: shipmentsShow x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /shipments/identifier/{id} method: get operationId: shipmentsShowByIdentifier x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /drop_shipment_confirmation method: post operationId: drop_shipment_confirmation x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /drop_shipment_cancellation method: post operationId: drop_shipment_cancellation x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /drop_shipment_partial_cancellation method: post operationId: drop_shipment_partial_cancellation x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /exchange_orders method: post operationId: exchange_orders x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /external_bin_changes method: post operationId: createExternalBinChange x-agentic-access: action-class: acting consequence: write subject: required scope: - read:external_bin_changes - write:external_bin_changes audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /external_bin_changes/{id} method: get operationId: showExternalBinChange x-agentic-access: action-class: connected consequence: read subject: optional scope: - read:external_bin_changes - write:external_bin_changes token: max-ttl: 3600 audit: none - path: /facilities method: post operationId: upsertFacility x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /final_dispositions method: post operationId: final_dispositions x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /forward_orders method: post x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /inventory_receipt method: post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /outbound_asn method: post operationId: outbound_asns x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /returns_portal_orders method: post operationId: returns_portal_orders x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /rmas method: post operationId: rmas x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /vendor_updates method: post operationId: vendorUpdate x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /sku/{parent_sku}/variants method: get operationId: variants x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none