eBay · Agentic Access

eBay Agentic Access

x-agentic-access generated

eBay exposes 200 API operations that an AI agent could call, of which 85 are state-changing ‘acting’ operations. This is a recommended x-agentic-access execution contract — the scope, audience, consequence tier, short-lived token constraints, and escalation each action should carry before it is handed to an autonomous agent.

By consequence: 115 read, 58 write, 25 physical, and 2 safety-critical.

2 operations are classed safety-critical and should require human-in-the-loop approval at runtime.

Contracts are classified heuristically from the provider’s OpenAPI and refresh on every APIs.io network build; audience is bound per deployment. The model follows Curity’s Access Intelligence (apidays Munich 2026). Browse every provider’s agent contracts at agentic-access.apis.io.

AuctionsCommerceProductsMarketplaceFortune 500
Operations: 200 Acting: 85 Human-in-the-loop: 2 Method: generated

By consequence

read 115 write 58 physical 25 safety-critical 2

Highest-consequence actions

The physical and safety-critical operations an agent could invoke — the ones that most warrant scoped tokens, tight TTLs, and escalation. Full per-operation contracts are in the source below.

MethodPathConsequenceHuman-in-loop
POST /location/{merchantLocationKey}/disable safety-critical required
POST /subscription/{subscription_id}/disable safety-critical required
POST /fulfillment_policy/ physical conditional
PUT /fulfillment_policy/{fulfillmentPolicyId} physical conditional
DELETE /fulfillment_policy/{fulfillmentPolicyId} physical conditional
POST /guest_checkout_session/initiate physical conditional
POST /guest_checkout_session/{checkoutSessionId}/apply_coupon physical conditional
POST /guest_checkout_session/{checkoutSessionId}/remove_coupon physical conditional
POST /guest_checkout_session/{checkoutSessionId}/update_quantity physical conditional
POST /guest_checkout_session/{checkoutSessionId}/update_shipping_address physical conditional
POST /guest_checkout_session/{checkoutSessionId}/update_shipping_option physical conditional
POST /offer/withdraw_by_inventory_item_group physical conditional
POST /offer/{offerId}/withdraw physical conditional
POST /order/{orderId}/shipping_fulfillment physical conditional
POST /order/{order_id}/issue_refund physical conditional
POST /order_task physical conditional
POST /payment_dispute/{payment_dispute_id}/accept physical conditional
POST /payment_dispute/{payment_dispute_id}/add_evidence physical conditional
POST /payment_dispute/{payment_dispute_id}/contest physical conditional
POST /payment_dispute/{payment_dispute_id}/update_evidence physical conditional
POST /payment_dispute/{payment_dispute_id}/upload_evidence_file physical conditional
POST /payment_policy physical conditional
PUT /payment_policy/{payment_policy_id} physical conditional
DELETE /payment_policy/{payment_policy_id} physical conditional
POST /shipment/create_from_shipping_quote physical conditional

Source

Agentic Access

Raw ↑ 
generated: '2026-07-15'
method: generated
source: openapi/ebay-account-openapi-original.yml, openapi/ebay-analytics-openapi-original.yml,
  openapi/ebay-browse-openapi-original.yml, openapi/ebay-catalog-openapi-original.yml, openapi/ebay-charity-openapi-original.yml,
  openapi/ebay-client-registration-openapi-original.yml, openapi/ebay-compliance-openapi-original.yml,
  openapi/ebay-deal-openapi-original.yml, openapi/ebay-feed-openapi-original.yml, openapi/ebay-finances-openapi-original.yml,
  openapi/ebay-fulfillment-openapi-original.yml, openapi/ebay-identity-openapi-original.yml,
  openapi/ebay-inventory-openapi-original.yml, openapi/ebay-key-management-openapi-original.yml,
  openapi/ebay-logistics-openapi-original.yml, openapi/ebay-market-openapi-original.yml, openapi/ebay-marketplace-insights-openapi-original.yml,
  openapi/ebay-media-openapi-original.yml, openapi/ebay-metadata-openapi-original.yml, openapi/ebay-notification-openapi-original.yml,
  openapi/ebay-offer-openapi-original.yml, openapi/ebay-order-openapi-original.yml, openapi/ebay-recommendation-openapi-original.yml,
  openapi/ebay-taxonomy-openapi-original.yml, openapi/ebay-translation-openapi-original.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: 200
  by_action_class:
    connected: 115
    acting: 85
  by_consequence:
    read: 115
    write: 58
    physical: 25
    safety-critical: 2
  human_in_the_loop_required: 2
operations:
- path: /custom_policy/
  method: get
  operationId: getCustomPolicies
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /custom_policy/
  method: post
  operationId: createCustomPolicy
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /custom_policy/{custom_policy_id}
  method: get
  operationId: getCustomPolicy
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /custom_policy/{custom_policy_id}
  method: put
  operationId: updateCustomPolicy
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /fulfillment_policy/
  method: post
  operationId: createFulfillmentPolicy
  x-agentic-access:
    action-class: acting
    consequence: physical
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    audience: null
    token:
      max-ttl: 300
      exchange: true
      purpose-required: true
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /fulfillment_policy/{fulfillmentPolicyId}
  method: get
  operationId: getFulfillmentPolicy
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /fulfillment_policy/{fulfillmentPolicyId}
  method: put
  operationId: updateFulfillmentPolicy
  x-agentic-access:
    action-class: acting
    consequence: physical
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    audience: null
    token:
      max-ttl: 300
      exchange: true
      purpose-required: true
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /fulfillment_policy/{fulfillmentPolicyId}
  method: delete
  operationId: deleteFulfillmentPolicy
  x-agentic-access:
    action-class: acting
    consequence: physical
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    audience: null
    token:
      max-ttl: 300
      exchange: true
      purpose-required: true
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /fulfillment_policy
  method: get
  operationId: getFulfillmentPolicies
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /fulfillment_policy/get_by_policy_name
  method: get
  operationId: getFulfillmentPolicyByName
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /payment_policy
  method: get
  operationId: getPaymentPolicies
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /payment_policy
  method: post
  operationId: createPaymentPolicy
  x-agentic-access:
    action-class: acting
    consequence: physical
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    audience: null
    token:
      max-ttl: 300
      exchange: true
      purpose-required: true
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /payment_policy/{payment_policy_id}
  method: get
  operationId: getPaymentPolicy
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /payment_policy/{payment_policy_id}
  method: put
  operationId: updatePaymentPolicy
  x-agentic-access:
    action-class: acting
    consequence: physical
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    audience: null
    token:
      max-ttl: 300
      exchange: true
      purpose-required: true
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /payment_policy/{payment_policy_id}
  method: delete
  operationId: deletePaymentPolicy
  x-agentic-access:
    action-class: acting
    consequence: physical
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    audience: null
    token:
      max-ttl: 300
      exchange: true
      purpose-required: true
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /payment_policy/get_by_policy_name
  method: get
  operationId: getPaymentPolicyByName
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /payments_program/{marketplace_id}/{payments_program_type}
  method: get
  operationId: getPaymentsProgram
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /payments_program/{marketplace_id}/{payments_program_type}/onboarding
  method: get
  operationId: getPaymentsProgramOnboarding
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /privilege
  method: get
  operationId: getPrivileges
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /program/get_opted_in_programs
  method: get
  operationId: getOptedInPrograms
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /program/opt_in
  method: post
  operationId: optInToProgram
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /program/opt_out
  method: post
  operationId: optOutOfProgram
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /rate_table
  method: get
  operationId: getRateTables
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /return_policy
  method: get
  operationId: getReturnPolicies
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /return_policy
  method: post
  operationId: createReturnPolicy
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /return_policy/{return_policy_id}
  method: get
  operationId: getReturnPolicy
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /return_policy/{return_policy_id}
  method: put
  operationId: updateReturnPolicy
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /return_policy/{return_policy_id}
  method: delete
  operationId: deleteReturnPolicy
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /return_policy/get_by_policy_name
  method: get
  operationId: getReturnPolicyByName
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /sales_tax/{countryCode}/{jurisdictionId}
  method: get
  operationId: getSalesTax
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /sales_tax/{countryCode}/{jurisdictionId}
  method: put
  operationId: createOrReplaceSalesTax
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /sales_tax/{countryCode}/{jurisdictionId}
  method: delete
  operationId: deleteSalesTax
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /sales_tax
  method: get
  operationId: getSalesTaxes
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /subscription
  method: get
  operationId: getSubscription
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /kyc
  method: get
  operationId: getKYC
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /advertising_eligibility
  method: get
  operationId: getAdvertisingEligibility
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.account
    - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /customer_service_metric/{customer_service_metric_type}/{evaluation_type}
  method: get
  operationId: getCustomerServiceMetric
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.analytics.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /seller_standards_profile
  method: get
  operationId: findSellerStandardsProfiles
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.analytics.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /seller_standards_profile/{program}/{cycle}
  method: get
  operationId: getSellerStandardsProfile
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.analytics.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /traffic_report
  method: get
  operationId: getTrafficReport
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.analytics.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /item_summary/search
  method: get
  operationId: search
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope
    token:
      max-ttl: 3600
    audit: none
- path: /item_summary/search_by_image
  method: post
  operationId: searchByImage
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /item/{item_id}
  method: get
  operationId: getItem
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope
    token:
      max-ttl: 3600
    audit: none
- path: /item/get_item_by_legacy_id
  method: get
  operationId: getItemByLegacyId
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope
    token:
      max-ttl: 3600
    audit: none
- path: /item/
  method: get
  operationId: getItems
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/buy.item.bulk
    token:
      max-ttl: 3600
    audit: none
- path: /item/get_items_by_item_group
  method: get
  operationId: getItemsByItemGroup
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope
    token:
      max-ttl: 3600
    audit: none
- path: /item/{item_id}/check_compatibility
  method: post
  operationId: checkCompatibility
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /product/{epid}
  method: get
  operationId: getProduct
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/commerce.catalog.readonly
    - https://api.ebay.com/oauth/api_scope/sell.inventory
    token:
      max-ttl: 3600
    audit: none
- path: /product_summary/search
  method: get
  operationId: search
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/commerce.catalog.readonly
    - https://api.ebay.com/oauth/api_scope/sell.inventory
    token:
      max-ttl: 3600
    audit: none
- path: /charity_org/{charity_org_id}
  method: get
  operationId: getCharityOrg
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope
    token:
      max-ttl: 3600
    audit: none
- path: /charity_org
  method: get
  operationId: getCharityOrgs
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope
    token:
      max-ttl: 3600
    audit: none
- path: /client/register
  method: post
  operationId: registerClient
  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: /listing_violation_summary
  method: get
  operationId: getListingViolationsSummary
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.inventory
    token:
      max-ttl: 3600
    audit: none
- path: /listing_violation
  method: get
  operationId: getListingViolations
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.inventory
    token:
      max-ttl: 3600
    audit: none
- path: /deal_item
  method: get
  operationId: getDealItems
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/buy.deal
    token:
      max-ttl: 3600
    audit: none
- path: /event/{event_id}
  method: get
  operationId: getEvent
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/buy.deal
    token:
      max-ttl: 3600
    audit: none
- path: /event
  method: get
  operationId: getEvents
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/buy.deal
    token:
      max-ttl: 3600
    audit: none
- path: /event_item
  method: get
  operationId: getEventItems
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/buy.deal
    token:
      max-ttl: 3600
    audit: none
- path: /order_task
  method: get
  operationId: getOrderTasks
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.fulfillment
    token:
      max-ttl: 3600
    audit: none
- path: /order_task
  method: post
  operationId: createOrderTask
  x-agentic-access:
    action-class: acting
    consequence: physical
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.fulfillment
    audience: null
    token:
      max-ttl: 300
      exchange: true
      purpose-required: true
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /order_task/{task_id}
  method: get
  operationId: getOrderTask
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.fulfillment
    token:
      max-ttl: 3600
    audit: none
- path: /inventory_task
  method: get
  operationId: getInventoryTasks
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.inventory
    token:
      max-ttl: 3600
    audit: none
- path: /inventory_task
  method: post
  operationId: createInventoryTask
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.inventory
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /inventory_task/{task_id}
  method: get
  operationId: getInventoryTask
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.inventory
    token:
      max-ttl: 3600
    audit: none
- path: /schedule
  method: get
  operationId: getSchedules
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/commerce.catalog.readonly
    - https://api.ebay.com/oauth/api_scope/sell.analytics.readonly
    - https://api.ebay.com/oauth/api_scope/sell.fulfillment
    - https://api.ebay.com/oauth/api_scope/sell.inventory
    - https://api.ebay.com/oauth/api_scope/sell.marketing
    token:
      max-ttl: 3600
    audit: none
- path: /schedule
  method: post
  operationId: createSchedule
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/commerce.catalog.readonly
    - https://api.ebay.com/oauth/api_scope/sell.analytics.readonly
    - https://api.ebay.com/oauth/api_scope/sell.fulfillment
    - https://api.ebay.com/oauth/api_scope/sell.inventory
    - https://api.ebay.com/oauth/api_scope/sell.marketing
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /schedule/{schedule_id}
  method: get
  operationId: getSchedule
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/commerce.catalog.readonly
    - https://api.ebay.com/oauth/api_scope/sell.analytics.readonly
    - https://api.ebay.com/oauth/api_scope/sell.fulfillment
    - https://api.ebay.com/oauth/api_scope/sell.inventory
    - https://api.ebay.com/oauth/api_scope/sell.marketing
    token:
      max-ttl: 3600
    audit: none
- path: /schedule/{schedule_id}
  method: put
  operationId: updateSchedule
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/commerce.catalog.readonly
    - https://api.ebay.com/oauth/api_scope/sell.analytics.readonly
    - https://api.ebay.com/oauth/api_scope/sell.fulfillment
    - https://api.ebay.com/oauth/api_scope/sell.inventory
    - https://api.ebay.com/oauth/api_scope/sell.marketing
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /schedule/{schedule_id}
  method: delete
  operationId: deleteSchedule
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/commerce.catalog.readonly
    - https://api.ebay.com/oauth/api_scope/sell.analytics.readonly
    - https://api.ebay.com/oauth/api_scope/sell.fulfillment
    - https://api.ebay.com/oauth/api_scope/sell.inventory
    - https://api.ebay.com/oauth/api_scope/sell.marketing
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /schedule/{schedule_id}/download_result_file
  method: get
  operationId: getLatestResultFile
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/commerce.catalog.readonly
    - https://api.ebay.com/oauth/api_scope/sell.analytics.readonly
    - https://api.ebay.com/oauth/api_scope/sell.fulfillment
    - https://api.ebay.com/oauth/api_scope/sell.inventory
    - https://api.ebay.com/oauth/api_scope/sell.marketing
    token:
      max-ttl: 3600
    audit: none
- path: /schedule_template/{schedule_template_id}
  method: get
  operationId: getScheduleTemplate
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/commerce.catalog.readonly
    - https://api.ebay.com/oauth/api_scope/sell.analytics.readonly
    - https://api.ebay.com/oauth/api_scope/sell.fulfillment
    - https://api.ebay.com/oauth/api_scope/sell.inventory
    - https://api.ebay.com/oauth/api_scope/sell.marketing
    token:
      max-ttl: 3600
    audit: none
- path: /schedule_template
  method: get
  operationId: getScheduleTemplates
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/commerce.catalog.readonly
    - https://api.ebay.com/oauth/api_scope/sell.analytics.readonly
    - https://api.ebay.com/oauth/api_scope/sell.fulfillment
    - https://api.ebay.com/oauth/api_scope/sell.inventory
    - https://api.ebay.com/oauth/api_scope/sell.marketing
    token:
      max-ttl: 3600
    audit: none
- path: /task
  method: get
  operationId: getTasks
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/commerce.catalog.readonly
    - https://api.ebay.com/oauth/api_scope/sell.analytics.readonly
    - https://api.ebay.com/oauth/api_scope/sell.fulfillment
    - https://api.ebay.com/oauth/api_scope/sell.inventory
    - https://api.ebay.com/oauth/api_scope/sell.marketing
    token:
      max-ttl: 3600
    audit: none
- path: /task
  method: post
  operationId: createTask
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/commerce.catalog.readonly
    - https://api.ebay.com/oauth/api_scope/sell.analytics.readonly
    - https://api.ebay.com/oauth/api_scope/sell.fulfillment
    - https://api.ebay.com/oauth/api_scope/sell.inventory
    - https://api.ebay.com/oauth/api_scope/sell.marketing
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /task/{task_id}/download_input_file
  method: get
  operationId: getInputFile
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/commerce.catalog.readonly
    - https://api.ebay.com/oauth/api_scope/sell.analytics.readonly
    - https://api.ebay.com/oauth/api_scope/sell.fulfillment
    - https://api.ebay.com/oauth/api_scope/sell.inventory
    - https://api.ebay.com/oauth/api_scope/sell.marketing
    token:
      max-ttl: 3600
    audit: none
- path: /task/{task_id}/download_result_file
  method: get
  operationId: getResultFile
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/commerce.catalog.readonly
    - https://api.ebay.com/oauth/api_scope/sell.analytics.readonly
    - https://api.ebay.com/oauth/api_scope/sell.fulfillment
    - https://api.ebay.com/oauth/api_scope/sell.inventory
    - https://api.ebay.com/oauth/api_scope/sell.marketing
    token:
      max-ttl: 3600
    audit: none
- path: /task/{task_id}
  method: get
  operationId: getTask
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/commerce.catalog.readonly
    - https://api.ebay.com/oauth/api_scope/sell.analytics.readonly
    - https://api.ebay.com/oauth/api_scope/sell.fulfillment
    - https://api.ebay.com/oauth/api_scope/sell.inventory
    - https://api.ebay.com/oauth/api_scope/sell.marketing
    token:
      max-ttl: 3600
    audit: none
- path: /task/{task_id}/upload_file
  method: post
  operationId: uploadFile
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - https://api.ebay.com/oauth/api_scope/commerce.catalog.readonly
    - https://api.ebay.com/oauth/api_scope/sell.analytics.readonly
    - https://api.ebay.com/oauth/api_scope/sell.fulfillment
    - https://api.ebay.com/oauth/api_scope/sell.inventory
    - https://api.ebay.com/oauth/api_scope/sell.marketing
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /customer_service_metric_task
  method: get
  operationId: getCustomerServiceMetricTasks
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - https://api.ebay.com/oauth/api_scope/sell.analytics.readonly
    token:
      max-ttl: 3600
    audit: none
- path: /custom

# --- truncated at 32 KB (77 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/ebay/refs/heads/main/agentic-access/ebay-agentic-access.yml