generated: '2026-07-15'
method: generated
source: openapi/spoton-reserve-openapi-original.yml, openapi/spoton-restaurant-pos-export-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: 26
  by_action_class:
    connected: 24
    acting: 2
  by_consequence:
    read: 24
    write: 2
  human_in_the_loop_required: 0
operations:
- path: /restaurants
  method: get
  operationId: listRestaurants
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v2/reservations/{restaurantId}/availability
  method: get
  operationId: getAvailableReservationTimes
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v2/reservations/{restaurantId}/wait-time
  method: get
  operationId: getWaitTime
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v2/reservations/{restaurantId}/reservation
  method: post
  operationId: createReservation
  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: /v2/reservations/{restaurantId}/waitlist
  method: post
  operationId: addToWaitlist
  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: /locations/{locationId}
  method: get
  operationId: getLocation
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /locations/{locationId}/orders
  method: get
  operationId: listOrders
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /locations/{locationId}/orders/{orderId}
  method: get
  operationId: getOrder
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /locations/{locationId}/order-types
  method: get
  operationId: listOrderTypes
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /locations/{locationId}/order-types/{orderTypeId}
  method: get
  operationId: getOrderType
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /locations/{locationId}/menu-items
  method: get
  operationId: listMenuItems
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /locations/{locationId}/menu-items/{menuItemId}
  method: get
  operationId: getMenuItem
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /locations/{locationId}/payment-options
  method: get
  operationId: listPaymentOptions
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /locations/{locationId}/payment-options/{paymentOptionId}
  method: get
  operationId: getPaymentOption
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /locations/{locationId}/employees
  method: get
  operationId: listEmployees
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /locations/{locationId}/employees/{employeeId}
  method: get
  operationId: getEmployee
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /locations/{locationId}/job-positions
  method: get
  operationId: listJobPositions
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /locations/{locationId}/job-positions/{jobPositionId}
  method: get
  operationId: getJobPosition
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /locations/{locationId}/time-clock-entries
  method: get
  operationId: listTimeClockEntries
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /locations/{locationId}/time-clock-entries/{timeClockEntryId}
  method: get
  operationId: getTimeClockEntry
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /locations/{locationId}/paid-in-outs
  method: get
  operationId: listPaidInOuts
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /locations/{locationId}/paid-in-outs/{paidInOutId}
  method: get
  operationId: getPaidInOut
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /locations/{locationId}/cash-deposits
  method: get
  operationId: listCashDeposits
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /locations/{locationId}/cash-deposits/{cashDepositId}
  method: get
  operationId: getCashDeposit
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /locations/{locationId}/report-categories
  method: get
  operationId: listReportCategories
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /locations/{locationId}/report-categories/{reportCategoryId}
  method: get
  operationId: getReportCategory
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none