generated: '2026-07-15'
method: generated
source: openapi/flightaware-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: 58
  by_action_class:
    connected: 52
    acting: 6
  by_consequence:
    read: 52
    write: 5
    safety-critical: 1
  human_in_the_loop_required: 1
operations:
- path: /flights/search
  method: get
  operationId: get_flights_by_search
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /flights/search/positions
  method: get
  operationId: get_flights_by_position_search
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /flights/search/count
  method: get
  operationId: get_flights_count_by_search
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /flights/search/advanced
  method: get
  operationId: get_flights_by_advanced_search
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /flights/{ident}
  method: get
  operationId: get_flight
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /flights/{ident}/canonical
  method: get
  operationId: get_flights_canonical
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /flights/{ident}/intents
  method: post
  operationId: post_flights_by_ident
  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: /flights/{id}/position
  method: get
  operationId: get_flight_position
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /flights/{id}/track
  method: get
  operationId: get_flight_track
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /flights/{id}/route
  method: get
  operationId: get_flight_route
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /flights/{id}/map
  method: get
  operationId: get_flight_map
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /foresight/flights/{ident}
  method: get
  operationId: get_flight_with_foresight
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /foresight/flights/search/advanced
  method: get
  operationId: get_flights_by_advanced_search_with_foresight
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /foresight/flights/{id}/position
  method: get
  operationId: get_flight_position_with_foresight
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /airports
  method: get
  operationId: get_all_airports
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /airports/nearby
  method: get
  operationId: get_nearby_airports
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /airports/delays
  method: get
  operationId: get_delays_for_all_airports
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /airports/{id}
  method: get
  operationId: get_airport
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /airports/{id}/canonical
  method: get
  operationId: get_airports_canonical
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /airports/{id}/nearby
  method: get
  operationId: get_airports_near_airport
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /airports/{id}/delays
  method: get
  operationId: get_airport_delays
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /airports/{id}/flights
  method: get
  operationId: get_airport_flights
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /airports/{id}/flights/arrivals
  method: get
  operationId: get_airport_flights_arrived
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /airports/{id}/flights/departures
  method: get
  operationId: get_airport_flights_departed
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /airports/{id}/flights/scheduled_departures
  method: get
  operationId: get_airport_flights_scheduled_departures
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /airports/{id}/flights/scheduled_arrivals
  method: get
  operationId: get_airport_flights_scheduled_arrivals
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /airports/{id}/flights/to/{dest_id}
  method: get
  operationId: get_flights_between_airports
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /airports/{id}/flights/counts
  method: get
  operationId: get_airport_flights_count
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /airports/{id}/weather/observations
  method: get
  operationId: get_airport_weather_observations
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /airports/{id}/weather/forecast
  method: get
  operationId: get_airport_weather_forecast
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /airports/{id}/routes/{dest_id}
  method: get
  operationId: get_routes_between_airports
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /operators
  method: get
  operationId: get_all_operators
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /operators/{id}
  method: get
  operationId: get_operator
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /operators/{id}/canonical
  method: get
  operationId: get_operators_canonical
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /operators/{id}/flights
  method: get
  operationId: get_operator_flights
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /operators/{id}/flights/scheduled
  method: get
  operationId: get_operator_flights_scheduled
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /operators/{id}/flights/arrivals
  method: get
  operationId: get_operator_flights_arrived
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /operators/{id}/flights/enroute
  method: get
  operationId: get_operator_flights_enroute
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /operators/{id}/flights/counts
  method: get
  operationId: get_operator_flights_count
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /alerts
  method: get
  operationId: get_all_alerts
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /alerts
  method: post
  operationId: create_alert
  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: /alerts/{id}
  method: get
  operationId: get_alert
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /alerts/{id}
  method: put
  operationId: update_alert
  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: /alerts/{id}
  method: delete
  operationId: delete_alert
  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: /alerts/endpoint
  method: get
  operationId: get_alerts_endpoint
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /alerts/endpoint
  method: put
  operationId: set_alerts_endpoint
  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: /alerts/endpoint
  method: delete
  operationId: delete_alerts_endpoint
  x-agentic-access:
    action-class: acting
    consequence: safety-critical
    subject: required
    audience: null
    token:
      max-ttl: 120
      exchange: true
      purpose-required: true
      proof-of-possession: true
    escalation:
      human-in-the-loop: required
    audit: required
- path: /history/flights/{ident}
  method: get
  operationId: get_history_flight
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /history/flights/{id}/track
  method: get
  operationId: get_history_flight_track
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /history/flights/{id}/map
  method: get
  operationId: get_history_flight_map
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /history/flights/{id}/route
  method: get
  operationId: get_history_flight_route
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /history/aircraft/{registration}/last_flight
  method: get
  operationId: get_history_aircraft_last_flight
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /aircraft/{ident}/blocked
  method: get
  operationId: get_aircraft_blocked
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /aircraft/{ident}/owner
  method: get
  operationId: get_aircraft_owner
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /aircraft/types/{type}
  method: get
  operationId: get_flight_type
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /schedules/{date_start}/{date_end}
  method: get
  operationId: get_schedules_by_date
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /disruption_counts/{entity_type}
  method: get
  operationId: get_all_disruption_counts
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /disruption_counts/{entity_type}/{id}
  method: get
  operationId: get_disruption_counts
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none