generated: '2026-07-15'
method: generated
source: openapi/gridstatus-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: 25
  by_action_class:
    connected: 25
  by_consequence:
    read: 25
  human_in_the_loop_required: 0
operations:
- path: /
  method: get
  operationId: apiInfo
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /datasets
  method: get
  operationId: listDatasets
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /datasets/{dataset_id}
  method: get
  operationId: getDatasetMetadata
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /datasets/{dataset_id}/audit
  method: get
  operationId: getDatasetAudit
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /datasets/{dataset_id}/query
  method: get
  operationId: queryDataset
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /datasets/{dataset_id}/query/{filter_column_id}/{filter_value_path}
  method: get
  operationId: queryDatasetByColumnValue
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /dataset-updates/{dataset_id}
  method: get
  operationId: getDatasetUpdates
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /block-pricing/{iso}
  method: get
  operationId: getBlockPricing
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /reports/daily_peak/{iso}
  method: get
  operationId: getDailyPeakReport
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /pricing_locations
  method: get
  operationId: listPricingLocations
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /pricing_locations/nearby
  method: get
  operationId: listNearbyPricingLocations
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /pricing_locations/{gs_entity_id}
  method: get
  operationId: getPricingLocation
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /constraints
  method: get
  operationId: listConstraints
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /constraints/contingencies
  method: get
  operationId: listContingencies
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /constraints/binding
  method: get
  operationId: listConstraintBindingRows
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /constraints/binding/counts
  method: get
  operationId: listConstraintBindingCounts
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /constraints/binding/costs
  method: get
  operationId: listConstraintBindingCosts
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /constraints/binding/heat_map
  method: get
  operationId: getConstraintBindingHeatMap
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /constraints/{gs_entity_id}
  method: get
  operationId: getConstraint
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /constraints/{constraint_id}/shift-factors
  method: get
  operationId: listShiftFactors
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /constraints/{constraint_id}/stats
  method: get
  operationId: listConstraintStats
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /constraints/locations/{location_gs_entity_id}/shift-factors
  method: get
  operationId: listShiftFactorsForLocation
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /csv-exports/{dataset_id}
  method: get
  operationId: listCsvExports
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /csv-exports/{dataset_id}/{export_date}
  method: get
  operationId: getCsvExportUrl
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api_usage
  method: get
  operationId: getApiUsage
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none