generated: '2026-07-15'
method: generated
source: openapi/va-appeals-status-api-openapi.yml, openapi/va-benefits-claims-api-openapi.yml,
  openapi/va-benefits-intake-api-openapi.yml, openapi/va-clinical-health-fhir-api-openapi.yml,
  openapi/va-facilities-api-openapi.yml, openapi/va-forms-api-openapi.yml, openapi/va-veteran-confirmation-api-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: 21
  by_action_class:
    connected: 16
    acting: 5
  by_consequence:
    read: 16
    write: 5
  human_in_the_loop_required: 0
operations:
- path: /appeals
  method: get
  operationId: listAppeals
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /veterans/{veteranId}/claims
  method: get
  operationId: listClaims
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /veterans/{veteranId}/claims/{id}
  method: get
  operationId: getClaim
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /veterans/{veteranId}/526
  method: post
  operationId: submit526
  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: /veterans/{veteranId}/intent-to-file
  method: post
  operationId: submitIntentToFile
  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: /veterans/{veteranId}/power-of-attorney
  method: get
  operationId: getPOA
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /uploads
  method: post
  operationId: createUpload
  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: /uploads/{id}
  method: get
  operationId: getUploadStatus
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /uploads/report
  method: post
  operationId: bulkStatusReport
  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: /Patient/{id}
  method: get
  operationId: readPatient
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
    scope:
    - launch/patient
    - patient/*.read
- path: /AllergyIntolerance
  method: get
  operationId: searchAllergies
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
    scope:
    - launch/patient
    - patient/*.read
- path: /Condition
  method: get
  operationId: searchConditions
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
    scope:
    - launch/patient
    - patient/*.read
- path: /Observation
  method: get
  operationId: searchObservations
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
    scope:
    - launch/patient
    - patient/*.read
- path: /MedicationRequest
  method: get
  operationId: searchMedicationRequests
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
    scope:
    - launch/patient
    - patient/*.read
- path: /facilities
  method: get
  operationId: listFacilities
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /facilities/{id}
  method: get
  operationId: getFacilityById
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /nearby
  method: get
  operationId: findNearby
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /facilities/{id}/services
  method: get
  operationId: getFacilityServices
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /forms
  method: get
  operationId: listForms
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /forms/{form_name}
  method: get
  operationId: getForm
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /status
  method: post
  operationId: confirmVeteranStatus
  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