generated: '2026-07-15'
method: generated
source: openapi/usda-ers-arms-openapi.yml, openapi/usda-fooddata-central-openapi.yml, openapi/usda-nass-quickstats-openapi.yml,
  openapi/usda-nrcs-awdb-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: 15
  by_action_class:
    connected: 15
  by_consequence:
    read: 15
  human_in_the_loop_required: 0
operations:
- path: /year
  method: get
  operationId: getAvailableYears
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /state
  method: get
  operationId: getAvailableStates
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /report
  method: get
  operationId: getAvailableReports
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /variable
  method: get
  operationId: getAvailableVariables
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /surveydata
  method: get
  operationId: getSurveyData
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /foods/search
  method: get
  operationId: searchFoods
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /food/{fdcId}
  method: get
  operationId: getFoodById
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /foods
  method: get
  operationId: getFoodsByIds
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /nutrients
  method: get
  operationId: getNutrients
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api_GET/
  method: get
  operationId: getAgriculturalStatistics
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /get_param_values/
  method: get
  operationId: getParameterValues
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /get_counts/
  method: get
  operationId: getRecordCount
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /stations
  method: get
  operationId: getStations
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data
  method: get
  operationId: getStationData
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /forecasts
  method: get
  operationId: getWaterSupplyForecasts
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none