generated: '2026-07-15'
method: generated
source: openapi/microsoft-visio-graph-api.yaml
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: 8
  by_action_class:
    connected: 8
  by_consequence:
    read: 8
  human_in_the_loop_required: 0
operations:
- path: /me/drive/items/{item-id}/workbook
  method: get
  operationId: getVisioDocument
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
    scope:
    - Files.Read
    - Files.ReadWrite
- path: /me/drive/items/{item-id}/workbook/pages
  method: get
  operationId: listPages
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
    scope:
    - Files.Read
    - Files.ReadWrite
- path: /me/drive/items/{item-id}/workbook/pages/{page-id}
  method: get
  operationId: getPage
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
    scope:
    - Files.Read
    - Files.ReadWrite
- path: /me/drive/items/{item-id}/workbook/pages/{page-id}/shapes
  method: get
  operationId: listShapes
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
    scope:
    - Files.Read
    - Files.ReadWrite
- path: /me/drive/items/{item-id}/workbook/pages/{page-id}/shapes/{shape-id}
  method: get
  operationId: getShape
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
    scope:
    - Files.Read
    - Files.ReadWrite
- path: /me/drive/items/{item-id}/workbook/pages/{page-id}/shapes/{shape-id}/shapeDataItems
  method: get
  operationId: listShapeDataItems
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
    scope:
    - Files.Read
    - Files.ReadWrite
- path: /me/drive/items/{item-id}/workbook/pages/{page-id}/shapes/{shape-id}/comments
  method: get
  operationId: listShapeComments
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
    scope:
    - Files.Read
    - Files.ReadWrite
- path: /me/drive/items/{item-id}/workbook/pages/{page-id}/shapes/{shape-id}/hyperlinks
  method: get
  operationId: listShapeHyperlinks
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
    scope:
    - Files.Read
    - Files.ReadWrite