Azure Files website screenshot

Azure Files

Azure Files is a fully managed cloud file share service from Microsoft Azure that provides hosted SMB and NFS file shares accessible from cloud and on-premises clients using standard file system protocols and the FileREST HTTPS API. It supports identity-based authentication via Active Directory and Microsoft Entra ID, snapshots, soft delete, and Azure File Sync for hybrid scenarios. The FileREST data-plane API uses shared key, shared access signatures (SAS), or Microsoft Entra ID OAuth 2.0 bearer tokens for authentication, while the control plane uses Azure Resource Manager.

Azure Files publishes 4 APIs on the APIs.io network, including Account API, Directories API, Files API, and 1 more. Tagged areas include Storage, File Storage, File Shares, SMB, and NFS.

Azure Files’ developer surface includes authentication, documentation, pricing, signup flow, engineering blog, and 5 more developer resources.

27.5/100 emerging ▬ flat Agent 28/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessSelf serve
6 APIs
StorageFile StorageFile SharesSMBNFSCloudAzure

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 27.5/100 · emerging
Contract Quality 13.7 / 25
Developer Ergonomics 4.3 / 20
Commercial Clarity 2.1 / 20
Operational Transparency 0.0 / 13
Governance 0.0 / 12
Discoverability 7.4 / 10
Agent readiness — 28/100 · agent aware
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 0 / 7
Rate-Limit Signaling 0 / 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/azure-file-storage: 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 6

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

Azure Files FileREST API

Data-plane HTTPS REST API for operations on file shares, directories, and files in Azure Files, including create, copy, lease, list, range, and snapshot operations. Authenticati...

Azure Storage Resource Provider API (File Services / Shares)

Azure Resource Manager REST API for managing storage accounts, FileService settings, and FileShare resources at the control-plane level. Authentication uses Microsoft Entra ID O...

Azure Files Account API

Account-level file service operations

Azure Files Directories API

Directory operations within a share

Azure Files Files API

File operations

Azure Files Shares API

File share operations

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Azure Files FileREST API

OPEN COLLECTION

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Azure File Storage Authentication

apiKey/oauth2 · 2 schemes

SECURITY

Azure File Storage Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Azure File Storage Vulnerability Disclosure

security.txt · contact published

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Azure File Storage Scopes

1 scope · clientCredentials

1 scopes

SCOPES

Agentic Access 1

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

Azure File Storage Agentic Access

11 operations · 6 acting

11 operations · 6 acting

AGENTIC

Resources

Get Started 1

Portal, sign-up, and the first successful call

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Access & Security 4

Authentication, authorization, and security posture

Commercial 1

Pricing, plans, and the legal terms of use

Company 2

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
aid: azure-file-storage
name: Azure Files
description: Azure Files is a fully managed cloud file share service from Microsoft Azure that provides hosted SMB and NFS
  file shares accessible from cloud and on-premises clients using standard file system protocols and the FileREST HTTPS API.
  It supports identity-based authentication via Active Directory and Microsoft Entra ID, snapshots, soft delete, and Azure
  File Sync for hybrid scenarios. The FileREST data-plane API uses shared key, shared access signatures (SAS), or Microsoft
  Entra ID OAuth 2.0 bearer tokens for authentication, while the control plane uses Azure Resource Manager.
type: Index
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/azure-file-storage.png
tags:
- Storage
- File Storage
- File Shares
- SMB
- NFS
- Cloud
- Azure
url: https://raw.githubusercontent.com/api-evangelist/azure-file-storage/refs/heads/main/apis.yml
created: '2026-05-11'
modified: '2026-05-11'
specificationVersion: '0.19'
apis:
- aid: azure-file-storage:filerest-api
  name: Azure Files FileREST API
  description: Data-plane HTTPS REST API for operations on file shares, directories, and files in Azure Files, including create,
    copy, lease, list, range, and snapshot operations. Authentication uses shared key, shared access signatures (SAS), or
    Microsoft Entra ID OAuth 2.0 bearer tokens.
  humanURL: https://learn.microsoft.com/en-us/rest/api/storageservices/file-service-rest-api
  baseURL: https://{account-name}.file.core.windows.net
  tags:
  - Azure Files
  - File Shares
  - Data Plane
  - Storage
  - Azure
  properties:
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/storageservices/file-service-rest-api
  - type: Operations on Shares
    url: https://learn.microsoft.com/en-us/rest/api/storageservices/operations-on-shares--file-service-
  - type: Operations on Files
    url: https://learn.microsoft.com/en-us/rest/api/storageservices/operations-on-files
- aid: azure-file-storage:storage-rp-api
  name: Azure Storage Resource Provider API (File Services / Shares)
  description: Azure Resource Manager REST API for managing storage accounts, FileService settings, and FileShare resources
    at the control-plane level. Authentication uses Microsoft Entra ID OAuth 2.0 bearer tokens.
  humanURL: https://learn.microsoft.com/en-us/rest/api/storagerp/file-shares
  baseURL: https://management.azure.com
  tags:
  - Storage
  - Control Plane
  - Resource Manager
  - Azure
  properties:
  - type: File Services
    url: https://learn.microsoft.com/en-us/rest/api/storagerp/file-services
  - type: File Shares
    url: https://learn.microsoft.com/en-us/rest/api/storagerp/file-shares
- aid: azure-file-storage:azure-file-storage-account-api
  name: Azure Files Account API
  description: Account-level file service operations
  humanURL: https://learn.microsoft.com/en-us/rest/api/storageservices/file-service-rest-api
  baseURL: https://{account-name}.file.core.windows.net
  tags:
  - Account
  properties:
  - type: OpenAPI
    url: openapi/azure-file-storage-account-api-openapi.yml
- aid: azure-file-storage:azure-file-storage-directories-api
  name: Azure Files Directories API
  description: Directory operations within a share
  humanURL: https://learn.microsoft.com/en-us/rest/api/storageservices/file-service-rest-api
  baseURL: https://{account-name}.file.core.windows.net
  tags:
  - Directories
  properties:
  - type: OpenAPI
    url: openapi/azure-file-storage-directories-api-openapi.yml
- aid: azure-file-storage:azure-file-storage-files-api
  name: Azure Files Files API
  description: File operations
  humanURL: https://learn.microsoft.com/en-us/rest/api/storageservices/file-service-rest-api
  baseURL: https://{account-name}.file.core.windows.net
  tags:
  - Files
  properties:
  - type: OpenAPI
    url: openapi/azure-file-storage-files-api-openapi.yml
- aid: azure-file-storage:azure-file-storage-shares-api
  name: Azure Files Shares API
  description: File share operations
  humanURL: https://learn.microsoft.com/en-us/rest/api/storageservices/file-service-rest-api
  baseURL: https://{account-name}.file.core.windows.net
  tags:
  - Shares
  properties:
  - type: OpenAPI
    url: openapi/azure-file-storage-shares-api-openapi.yml
common:
- type: AgenticAccess
  url: agentic-access/azure-file-storage-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/azure-file-storage-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/azure-file-storage-domain-security.yml
- type: Authentication
  url: authentication/azure-file-storage-authentication.yml
- type: OAuthScopes
  url: scopes/azure-file-storage-scopes.yml
- type: Website
  url: https://azure.microsoft.com/en-us/products/storage/files/
- type: Documentation
  url: https://learn.microsoft.com/en-us/azure/storage/files/
- type: Pricing
  url: https://azure.microsoft.com/en-us/pricing/details/storage/files/
- type: Signup
  url: https://azure.microsoft.com/en-us/free/
- url: https://techcommunity.microsoft.com/t5/s/gxcuf89792/rss/board?board.id=AzureStorageBlog
  type: Blog
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com