Microsoft Visio

APIs and resources for Microsoft Visio, a diagramming and vector graphics application that helps visualize data-connected business process flows. Provides programmatic access to diagrams, pages, shapes, data items, comments, and hyperlinks through Microsoft Graph and JavaScript APIs.

Microsoft Visio publishes 6 APIs on the APIs.io network, including Comments API, Documents API, Hyperlinks API, and 3 more. Tagged areas include Business Process, Diagramming, Flowcharts, Microsoft 365, and Visualization.

The Microsoft Visio catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Microsoft Visio’s developer surface includes authentication, support, engineering blog, pricing, and 11 more developer resources.

🌐 Visit website 📡 Source on GitHub

58.2/100 strong ▼ -6.9 Agent 37/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6

AccessFreemiumSelf serve⚡ Free to try

7 APIs 5 Features 3 Use Cases

Business ProcessDiagrammingFlowchartsMicrosoft 365Visualization

Kin Score

Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6

Composite quality — 58.2/100 · strong

Contract Quality 17.1 / 25

Developer Ergonomics 4.3 / 20

Commercial Clarity 14.2 / 20

Operational Transparency 6.8 / 13

Governance 8.3 / 12

Discoverability 7.4 / 10

Agent readiness — 37/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/microsoft-visio: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 7

Individual APIs this provider publishes, each with its own machine-readable definition.

Rate Limits 1

Documented rate limits and quota policies.

Microsoft Visio Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Microsoft Visio Finops

FINOPS

Features 5

Notable capabilities this provider offers.

Diagram Rendering

Render Visio diagrams in the browser via JavaScript API.

Shape Data Access

Read data items attached to diagram shapes.

Page Navigation

Navigate and list pages within Visio documents.

Comment Support

Read and manage comments on shapes.

Hyperlink Management

Access hyperlinks associated with diagram shapes.

JSON Schema 5

Standalone JSON Schema definitions for this provider's data models.

Examples 5

Example request and response payloads for these APIs.

Scopes 1

OAuth scopes governing access to this provider's APIs.

Microsoft Visio Scopes

2 scopes · authorizationCode

2 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Microsoft Visio Agentic Access

8 operations

8 operations · 0 acting

AGENTIC

Use Cases 3

What developers build with this provider.

Network Topology Analysis

Programmatically analyze network diagrams for infrastructure review.

Business Process Review

Extract and analyze business process flow data from diagrams.

Compliance Auditing

Inspect diagram shapes and data for compliance validation.

Resources

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

SpectralRules

SpectralRules

Vocabulary

Vocabulary

Build 2

SDKs, sample code, and the tooling you integrate with

PostmanWorkspace

PostmanWorkspace

GitHubOrganization

GitHubOrganization

Access & Security 4

Authentication, authorization, and security posture

VulnerabilityDisclosure

VulnerabilityDisclosure

DomainSecurity

DomainSecurity

Authentication

Authentication

OAuthScopes

OAuthScopes

Operate 2

Status, limits, changes, and where to get help

Support

Support

StatusPage

StatusPage

Commercial 3

Pricing, plans, and the legal terms of use

PrivacyPolicy

PrivacyPolicy

TermsOfService

TermsOfService

Pricing

Pricing

Company 1

The organization behind the API

Blog

Blog

Source (apis.yml)

aid: microsoft-visio
name: Microsoft Visio
description: APIs and resources for Microsoft Visio, a diagramming and vector graphics application that helps visualize data-connected
  business process flows. Provides programmatic access to diagrams, pages, shapes, data items, comments, and hyperlinks through
  Microsoft Graph and JavaScript APIs.
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://learn.microsoft.com/en-us/graph/images/visio-logo.png
url: https://raw.githubusercontent.com/api-evangelist/microsoft-visio/refs/heads/main/apis.yml
humanURL: https://www.microsoft.com/en-us/microsoft-365/visio/microsoft-visio-plans-and-pricing-compare-visio-options
created: '2024'
modified: '2026-05-19'
specificationVersion: '0.19'
type: Index
tags:
- Business Process
- Diagramming
- Flowcharts
- Microsoft 365
- Visualization
apis:
- name: Visio JavaScript API
  description: JavaScript API for building add-ins and extending Visio functionality in the browser with access to documents,
    pages, shapes, and comments.
  humanURL: https://learn.microsoft.com/en-us/javascript/api/visio
  baseURL: https://learn.microsoft.com/en-us/javascript/api/visio
  tags:
  - Add-Ins
  - Browser
  - JavaScript
  - Office Add-Ins
  properties:
  - type: Documentation
    url: https://learn.microsoft.com/en-us/javascript/api/visio
  - type: APIReference
    url: https://learn.microsoft.com/en-us/javascript/api/visio?view=visio-js-1.1
  - type: GettingStarted
    url: https://learn.microsoft.com/en-us/office/dev/add-ins/visio/visio-add-ins-overview
  - type: CodeExamples
    url: https://github.com/OfficeDev/Office-Add-in-samples
- aid: microsoft-visio:microsoft-visio-comments-api
  name: Microsoft Visio Comments API
  description: Operations for reading and managing shape comments.
  humanURL: https://learn.microsoft.com/en-us/graph/api/resources/visio
  baseURL: https://graph.microsoft.com/v1.0
  tags:
  - Comments
  properties:
  - type: OpenAPI
    url: openapi/microsoft-visio-comments-api-openapi.yml
  - type: Documentation
    url: https://learn.microsoft.com/en-us/graph/api/resources/visio
  - type: Authentication
    url: https://learn.microsoft.com/en-us/graph/auth/
  - type: GettingStarted
    url: https://learn.microsoft.com/en-us/graph/api/resources/visio
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-page-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-shape-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-shape-data-item-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-comment-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-hyperlink-schema.json
  - type: JSONStructure
    url: json-structure/visio-graph-api-visio-page-structure.json
  - type: JSONLD
    url: json-ld/microsoft-visio-graph-api-context.jsonld
  - type: Examples
    url: examples/visio-graph-api-visio-page-example.json
  - type: Examples
    url: examples/visio-graph-api-visio-shape-example.json
- aid: microsoft-visio:microsoft-visio-documents-api
  name: Microsoft Visio Documents API
  description: Operations for Visio document metadata.
  humanURL: https://learn.microsoft.com/en-us/graph/api/resources/visio
  baseURL: https://graph.microsoft.com/v1.0
  tags:
  - Documents
  properties:
  - type: OpenAPI
    url: openapi/microsoft-visio-documents-api-openapi.yml
  - type: Documentation
    url: https://learn.microsoft.com/en-us/graph/api/resources/visio
  - type: Authentication
    url: https://learn.microsoft.com/en-us/graph/auth/
  - type: GettingStarted
    url: https://learn.microsoft.com/en-us/graph/api/resources/visio
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-page-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-shape-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-shape-data-item-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-comment-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-hyperlink-schema.json
  - type: JSONStructure
    url: json-structure/visio-graph-api-visio-page-structure.json
  - type: JSONLD
    url: json-ld/microsoft-visio-graph-api-context.jsonld
  - type: Examples
    url: examples/visio-graph-api-visio-page-example.json
  - type: Examples
    url: examples/visio-graph-api-visio-shape-example.json
- aid: microsoft-visio:microsoft-visio-hyperlinks-api
  name: Microsoft Visio Hyperlinks API
  description: Operations for reading shape hyperlinks.
  humanURL: https://learn.microsoft.com/en-us/graph/api/resources/visio
  baseURL: https://graph.microsoft.com/v1.0
  tags:
  - Hyperlinks
  properties:
  - type: OpenAPI
    url: openapi/microsoft-visio-hyperlinks-api-openapi.yml
  - type: Documentation
    url: https://learn.microsoft.com/en-us/graph/api/resources/visio
  - type: Authentication
    url: https://learn.microsoft.com/en-us/graph/auth/
  - type: GettingStarted
    url: https://learn.microsoft.com/en-us/graph/api/resources/visio
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-page-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-shape-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-shape-data-item-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-comment-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-hyperlink-schema.json
  - type: JSONStructure
    url: json-structure/visio-graph-api-visio-page-structure.json
  - type: JSONLD
    url: json-ld/microsoft-visio-graph-api-context.jsonld
  - type: Examples
    url: examples/visio-graph-api-visio-page-example.json
  - type: Examples
    url: examples/visio-graph-api-visio-shape-example.json
- aid: microsoft-visio:microsoft-visio-pages-api
  name: Microsoft Visio Pages API
  description: Operations for managing pages in Visio documents.
  humanURL: https://learn.microsoft.com/en-us/graph/api/resources/visio
  baseURL: https://graph.microsoft.com/v1.0
  tags:
  - Pages
  properties:
  - type: OpenAPI
    url: openapi/microsoft-visio-pages-api-openapi.yml
  - type: Documentation
    url: https://learn.microsoft.com/en-us/graph/api/resources/visio
  - type: Authentication
    url: https://learn.microsoft.com/en-us/graph/auth/
  - type: GettingStarted
    url: https://learn.microsoft.com/en-us/graph/api/resources/visio
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-page-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-shape-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-shape-data-item-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-comment-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-hyperlink-schema.json
  - type: JSONStructure
    url: json-structure/visio-graph-api-visio-page-structure.json
  - type: JSONLD
    url: json-ld/microsoft-visio-graph-api-context.jsonld
  - type: Examples
    url: examples/visio-graph-api-visio-page-example.json
  - type: Examples
    url: examples/visio-graph-api-visio-shape-example.json
- aid: microsoft-visio:microsoft-visio-shape-data-api
  name: Microsoft Visio Shape Data API
  description: Operations for reading shape data items.
  humanURL: https://learn.microsoft.com/en-us/graph/api/resources/visio
  baseURL: https://graph.microsoft.com/v1.0
  tags:
  - Shape Data
  properties:
  - type: OpenAPI
    url: openapi/microsoft-visio-shape-data-api-openapi.yml
  - type: Documentation
    url: https://learn.microsoft.com/en-us/graph/api/resources/visio
  - type: Authentication
    url: https://learn.microsoft.com/en-us/graph/auth/
  - type: GettingStarted
    url: https://learn.microsoft.com/en-us/graph/api/resources/visio
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-page-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-shape-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-shape-data-item-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-comment-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-hyperlink-schema.json
  - type: JSONStructure
    url: json-structure/visio-graph-api-visio-page-structure.json
  - type: JSONLD
    url: json-ld/microsoft-visio-graph-api-context.jsonld
  - type: Examples
    url: examples/visio-graph-api-visio-page-example.json
  - type: Examples
    url: examples/visio-graph-api-visio-shape-example.json
- aid: microsoft-visio:microsoft-visio-shapes-api
  name: Microsoft Visio Shapes API
  description: Operations for managing shapes on pages.
  humanURL: https://learn.microsoft.com/en-us/graph/api/resources/visio
  baseURL: https://graph.microsoft.com/v1.0
  tags:
  - Shapes
  properties:
  - type: OpenAPI
    url: openapi/microsoft-visio-shapes-api-openapi.yml
  - type: Documentation
    url: https://learn.microsoft.com/en-us/graph/api/resources/visio
  - type: Authentication
    url: https://learn.microsoft.com/en-us/graph/auth/
  - type: GettingStarted
    url: https://learn.microsoft.com/en-us/graph/api/resources/visio
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-page-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-shape-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-shape-data-item-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-comment-schema.json
  - type: JSONSchema
    url: json-schema/visio-graph-api-visio-hyperlink-schema.json
  - type: JSONStructure
    url: json-structure/visio-graph-api-visio-page-structure.json
  - type: JSONLD
    url: json-ld/microsoft-visio-graph-api-context.jsonld
  - type: Examples
    url: examples/visio-graph-api-visio-page-example.json
  - type: Examples
    url: examples/visio-graph-api-visio-shape-example.json
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/microsoft-visio/overview
- type: AgenticAccess
  url: agentic-access/microsoft-visio-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/microsoft-visio-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/microsoft-visio-domain-security.yml
- type: Authentication
  url: authentication/microsoft-visio-authentication.yml
- type: OAuthScopes
  url: scopes/microsoft-visio-scopes.yml
- type: Support
  url: https://support.microsoft.com/visio
- type: Blog
  url: https://techcommunity.microsoft.com/t5/visio-blog/bg-p/VisioBlog
- type: PrivacyPolicy
  url: https://privacy.microsoft.com/en-us/privacystatement
- type: TermsOfService
  url: https://www.microsoft.com/en-us/servicesagreement
- type: StatusPage
  url: https://status.microsoft365.com/
- type: Pricing
  url: https://www.microsoft.com/en-us/microsoft-365/visio/microsoft-visio-plans-and-pricing-compare-visio-options
- type: GitHubOrganization
  url: https://github.com/OfficeDev
- type: SpectralRules
  url: rules/microsoft-visio-spectral-rules.yml
- type: Vocabulary
  url: vocabulary/microsoft-visio-vocabulary.yaml
- type: Features
  data:
  - name: Diagram Rendering
    description: Render Visio diagrams in the browser via JavaScript API.
  - name: Shape Data Access
    description: Read data items attached to diagram shapes.
  - name: Page Navigation
    description: Navigate and list pages within Visio documents.
  - name: Comment Support
    description: Read and manage comments on shapes.
  - name: Hyperlink Management
    description: Access hyperlinks associated with diagram shapes.
- type: UseCases
  data:
  - name: Network Topology Analysis
    description: Programmatically analyze network diagrams for infrastructure review.
  - name: Business Process Review
    description: Extract and analyze business process flow data from diagrams.
  - name: Compliance Auditing
    description: Inspect diagram shapes and data for compliance validation.
- type: Integrations
  data:
  - name: SharePoint
    description: Access Visio files stored in SharePoint document libraries.
  - name: OneDrive
    description: Work with Visio diagrams in OneDrive for Business.
  - name: Power Automate
    description: Trigger workflows based on Visio diagram changes.
- type: Integrations
  url: https://www.microsoft.com/en-us/marketplace
integrations:
- name: Microsoft
- name: Two people looking at a computer.
- name: This is placeholder text for
- name: IDC
- name: Nationwide
- name: RSA company
- name: Teleperformance
- name: A woman smiling at a laptop
- name: A man holding a laptop.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com