microsoftdocs/agent-skills

azure-health-data-services

Expert knowledge for Azure Health Data Services development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using FHIR/DICOM APIs, bulk import/export, de-identification, events, or Synapse/Data Lake integrations, and other Azure Health Data Services related development tasks. Not for Azure Health Bot (use azure-health-bot), Azure Data Manager for Agricul…

First seen Mar 8, 2026

Installation

$ npx skills add microsoftdocs/agent-skills --skill azure-health-data-services

Summary

  • Expert knowledge for Azure Health Data Services development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment.
  • Use when using FHIR/DICOM APIs, bulk import/export, de-identification, events, or Synapse/Data Lake integrations, and other Azure Health Data Services related development tasks.
  • Not for Azure Health Bot (use azure-health-bot), Azure Data Manager for Agriculture (use azure-data-manager-for-agri), Azure Energy Data Services (use azure-energy-data-services).

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from microsoftdocs/agent-skills · top by installs.

npx skills add microsoftdocs/agent-skills

Browse all from microsoftdocs/agent-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 737
License LICENSE
Default branch main
Open issues 2
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

CompatibilityRequires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
More metadata
generated_at
2026-08-31
generator
docs2skills/1.0.0

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 26,397 B
  • docs SUMMARY.md 633 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 127 installs

SKILL.md

Azure Health Data Services Skill

This skill provides expert guidance for Azure Health Data Services. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use readfile with the specified lines. For categories with file links (e.g., [security.md](security.md)), use readfile on the linked reference file

IMPORTANT for Agent: If metadata.generatedat is more than 3 months old, suggest the user pull the latest version from the repository. If mcpmicrosoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

  • Preferred: Use mcpmicrosoftdocs:microsoftdocs_fetch with query string from=learn-agent-skill. Returns Markdown.
  • Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category Lines Description
Troubleshooting L37-L46 Diagnosing and fixing token/auth issues, event delivery problems, $convert-data errors/performance, identity provider setup, and known Azure Health Data Services limitations.
Best Practices L47-L55 BCDR planning, CMK encryption for FHIR/DICOM, FHIR performance tuning, and safe configuration/operation of FHIR reindex jobs
Decision Making L56-L63 Guidance on common Azure API for FHIR issues and detailed migration plans from Azure API for FHIR and SMART on FHIR proxy to Azure Health Data Services FHIR.
Architecture & Design Patterns L64-L70 Architectural patterns for FHIR, DICOM, and de-identification: disaster recovery setup, reliable anonymization services, DICOM + Data Lake integration, and digital pathology workflow design.
Limits & Quotas L71-L76 Scaling and performance limits for Azure API for FHIR and DICOM: autoscale setup, throughput and request caps, storage and size constraints, and service-specific behavior under load.
Security L77-L116 Configuring auth, RBAC, identities, keys, policies, network access, and token flows for secure FHIR, DICOM, and de-identification services in Azure Health Data Services
Configuration L117-L167 Configuring Azure FHIR and DICOM services: bulk import/export, de-identification, search, history, logging, CORS, profiles, conformance, events, and integration with CARIN/Da Vinci standards.
Integrations & Coding Patterns L168-L204 Using FHIR and DICOM APIs with cURL/SDKs, bulk export/import, search, de-identification, events, and integrating with Synapse, ADF, Logic Apps, and Da Vinci/CARIN implementations
Deployment L205-L218 How to deploy and move Azure Health Data Services (FHIR, DICOM, de-identification, workspaces) using portal, ARM, Bicep, CLI, PowerShell, and check regional availability

Troubleshooting

Best Practices

Decision Making

Architecture & Design Patterns

Topic URL
Configure disaster recovery for Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/disaster-recovery
Architect DICOM service with Azure Data Lake Storage https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/dicom-data-lake
Implement digital pathology workflows with DICOM service https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/dicom-digital-pathology

Limits & Quotas

Security

Topic URL
Configure authentication and authorization for Health Data Services https://learn.microsoft.com/en-us/azure/healthcare-apis/authentication-authorization
Configure Entra identity and auth for Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/azure-active-directory-identity-configuration
Configure Azure RBAC for Azure API for FHIR data plane https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/configure-azure-rbac
Configure local RBAC with secondary Entra tenant for Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/configure-local-rbac
Configure customer-managed keys for Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/customer-managed-key
Register Microsoft Entra apps for Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/fhir-app-registration
Locate identity object IDs for Azure API for FHIR auth https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/find-identity-object-ids
Get Azure API for FHIR access token via Azure CLI https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/get-healthcare-apis-access-token-cli
Apply built-in Azure Policy definitions to Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/policy-reference
Register confidential client apps for Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/register-confidential-azure-ad-client-app
Register public client apps for Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/register-public-azure-ad-client-app
Register resource (API) app for Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/register-resource-azure-ad-client-app
Register service client apps for Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/register-service-azure-ad-client-app
Apply regulatory compliance policies to Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/security-controls-policy
Register public client apps for Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/tutorial-web-app-public-app-reg
Use built-in Azure Policies for Health Data Services compliance https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-health-data-services-policy-reference
Configure Azure RBAC for FHIR and DICOM services https://learn.microsoft.com/en-us/azure/healthcare-apis/configure-azure-rbac
Grant FHIR and DICOM access using CLI and REST https://learn.microsoft.com/en-us/azure/healthcare-apis/configure-azure-rbac-using-scripts
Configure Private Link for Azure Health Data Services https://learn.microsoft.com/en-us/azure/healthcare-apis/configure-private-link
Configure private endpoint access for de-identification service https://learn.microsoft.com/en-us/azure/healthcare-apis/deidentification/configure-private-endpoints
Manage de-identification service access with Azure RBAC https://learn.microsoft.com/en-us/azure/healthcare-apis/deidentification/manage-access-rbac
Use managed identities with de-identification service https://learn.microsoft.com/en-us/azure/healthcare-apis/deidentification/managed-identities
Configure customer-managed keys for DICOM encryption https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/configure-customer-managed-keys
Configure Azure RBAC roles for DICOM service https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/dicom-configure-azure-rbac
Register client applications for DICOM service in Entra ID https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/dicom-register-application
Request access tokens for DICOM service https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/get-access-token
Configure Azure AD B2C access to FHIR service https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/azure-ad-b2c-setup
Configure Entra External ID access for Azure FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/azure-entra-external-id-setup
Configure customer-managed keys for FHIR encryption https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/configure-customer-managed-keys
Configure secure FHIR export to Azure Storage https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/configure-export-data
Configure multiple identity providers for FHIR service https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/configure-identity-providers
Configure SMART on FHIR security for AHDS FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/smart-on-fhir
Obtain access tokens for FHIR and DICOM services https://learn.microsoft.com/en-us/azure/healthcare-apis/get-access-token
Configure network access security for Health Data Services https://learn.microsoft.com/en-us/azure/healthcare-apis/network-access-security
Register Entra client app for Azure Health Data Services https://learn.microsoft.com/en-us/azure/healthcare-apis/register-application
Scripted Entra app registration for Health Data Services https://learn.microsoft.com/en-us/azure/healthcare-apis/register-application-cli-rest

Configuration

Topic URL
Configure bulk delete operations for Azure FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/bulk-delete-operation
Configure Azure API for FHIR for CARIN Blue Button https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/carin-implementation-guide-blue-button-tutorial
Configure CORS for Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/configure-cross-origin-resource-sharing
Configure database settings for Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/configure-database
Configure bulk export settings for Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/configure-export-data
Set up Private Link for Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/configure-private-link
Configure Azure API for FHIR for Da Vinci Drug Formulary https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/davinci-drug-formulary-tutorial
Configure Azure API for FHIR for Da Vinci PDex https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/davinci-pdex-tutorial
Configure Azure API for FHIR for Da Vinci Plan Net https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/davinci-plan-net
Set up de-identified export for Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/de-identified-export
Enable diagnostic logging for Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/enable-diagnostic-logging
Review supported FHIR features in Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/fhir-features-supported
Define custom search parameters in Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/how-to-do-custom-search
Run reindex jobs in Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/how-to-run-a-reindex
Manage FHIR history with $purge-history in Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/purge-history
Store and manage FHIR profiles in Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/store-profiles-in-fhir
Add custom headers to Azure API for FHIR audit logs https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/use-custom-headers
Configure FHIR profile validation in Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/validation-against-profiles
Configure Azure Storage for de-identification batch jobs https://learn.microsoft.com/en-us/azure/healthcare-apis/deidentification/configure-storage
Configure monitoring and alerts for de-identification service https://learn.microsoft.com/en-us/azure/healthcare-apis/deidentification/monitor-deidentification-service
Reference for de-identification service monitoring data https://learn.microsoft.com/en-us/azure/healthcare-apis/deidentification/monitor-deidentification-service-reference
Define custom redaction formats for de-identification service https://learn.microsoft.com/en-us/azure/healthcare-apis/deidentification/redaction-format
Configure CORS settings for DICOM service https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/configure-cross-origin-resource-sharing
Customize image location URLs in DICOM responses https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/dicom-proxy-url-support
Understand DICOM service v1 conformance and APIs https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/dicom-services-conformance-statement
Implement Azure DICOM service v2 conformance https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/dicom-services-conformance-statement-v2
Enable and query DICOM diagnostic logging https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/enable-diagnostic-logging
Disable FHIR and DICOM events by deleting subscriptions https://learn.microsoft.com/en-us/azure/healthcare-apis/events/events-disable-delete-workspace
Understand Azure Health Data Services event message schema https://learn.microsoft.com/en-us/azure/healthcare-apis/events/events-message-structure
Configure CORS settings for Azure FHIR service https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/configure-cross-origin-resource-sharing
Configure FHIR import settings and storage access https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/configure-import-data
Configure $convert-data templates in Azure FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/convert-data-configuration
Configure de-identified FHIR data export https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/deidentified-export
Run bulk $export operations on FHIR data https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/export-data
Use $docref to fetch patient DocumentReferences https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/fhir-docref
Use $expand to resolve FHIR ValueSets https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/fhir-expand
Configure and query FHIR diagnostic logs https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/fhir-service-diagnostic-logs
Configure FHIR versioning policy and history retention https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/fhir-versioning-policy-and-history-management
Define and manage custom FHIR search parameters https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/how-to-do-custom-search
Use FHIR import operation for NDJSON data https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/import-data
Use Patient-everything operation in FHIR service https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/patient-everything
Use $purge-history to delete FHIR resource history https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/purge-history
Configure selectable search parameters in Azure FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/selectable-search-parameters
Store FHIR profiles in Azure Health Data Services https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/store-profiles-in-fhir
Use $member-match operation on FHIR service https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/tutorial-member-match
Configure custom HTTP headers for FHIR audit logs https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/use-custom-headers-diagnosticlog
Validate FHIR resources against stored profiles https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/validation-against-profiles

Integrations & Coding Patterns

Topic URL
Access FHIR and DICOM APIs with cURL and SDKs https://learn.microsoft.com/en-us/azure/healthcare-apis/access-healthcare-apis
Use $convert-data endpoint in Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/convert-data
Copy Azure API for FHIR data into Synapse https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/copy-to-synapse
Execute FHIR bulk $export with Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/export-data
Use FHIR REST API capabilities in Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/fhir-rest-api-capabilities
Use Patient-everything operation in Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/patient-everything
Use FHIR search examples with Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/search-samples
Use $member-match operation with Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/tutorial-member-match
Build a web app that calls Azure API for FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/tutorial-web-app-write-web-app
Bulk de-identify documents via asynchronous Python API https://learn.microsoft.com/en-us/azure/healthcare-apis/deidentification/quickstart-asynchronous-python
Call synchronous de-identification endpoint with Python https://learn.microsoft.com/en-us/azure/healthcare-apis/deidentification/quickstart-python
Use .NET client library for Azure Health de-identification https://learn.microsoft.com/en-us/azure/healthcare-apis/deidentification/quickstart-sdk-net
Call DICOMweb APIs with C# and sample DICOM files https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/dicomweb-standard-apis-c-sharp
Call DICOMweb APIs with cURL and sample DICOM files https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/dicomweb-standard-apis-curl
Call DICOMweb APIs with Python and sample DICOM files https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/dicomweb-standard-apis-python
Use DICOMweb and custom APIs to manage DICOM data https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/dicomweb-standard-apis-with-dicom-services
Export DICOM files to Azure Blob Storage https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/export-files
Store and query external metadata in DICOM service https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/external-metadata
Use DICOM data with Azure Data Factory and Fabric https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/get-started-with-analytics-dicom
Bulk import DICOM files into Azure DICOM service https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/import-files
Consume DICOM Change Feed using C# client https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/pull-dicom-changes-from-change-feed
Use bulk update API for DICOM file metadata https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/update-files
Consume FHIR events with Azure Logic Apps workflows https://learn.microsoft.com/en-us/azure/healthcare-apis/events/events-consume-logic-apps
Configure Azure FHIR for CARIN Blue Button tests https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/carin-implementation-guide-blue-button-tutorial
Copy FHIR data to Azure Synapse Analytics https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/copy-to-synapse
Set up Azure FHIR for Da Vinci Drug Formulary https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/davinci-drug-formulary-tutorial
Configure Azure FHIR for Da Vinci PDex compliance https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/davinci-pdex-tutorial
Implement Da Vinci Plan Net on Azure FHIR https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/davinci-plan-net
Use FHIR bulk delete operations in Azure Health Data Services https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/fhir-bulk-delete
Use $bulk-update for FHIR resource batch updates https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/fhir-bulk-update
Use FHIR search examples in Azure Health Data Services https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/search-samples
Access Azure Health Data Services APIs with cURL https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/using-curl
Access Azure Health Data Services using VS Code REST Client https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/using-rest-client

Deployment

Topic URL
Move Azure API for FHIR between subscriptions or groups https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/move-fhir-service
Deploy de-identification service in Azure Health Data Services https://learn.microsoft.com/en-us/azure/healthcare-apis/deidentification/quickstart
Deploy de-identification service using ARM template https://learn.microsoft.com/en-us/azure/healthcare-apis/deidentification/quickstart-arm
Deploy de-identification service using Azure CLI https://learn.microsoft.com/en-us/azure/healthcare-apis/deidentification/quickstart-azure-cli
Deploy de-identification service with Bicep https://learn.microsoft.com/en-us/azure/healthcare-apis/deidentification/quickstart-bicep
Deploy de-identification service using Azure PowerShell https://learn.microsoft.com/en-us/azure/healthcare-apis/deidentification/quickstart-powershell
Deploy Azure Health Data Services workspace with Bicep https://learn.microsoft.com/en-us/azure/healthcare-apis/deploy-healthcare-apis-using-bicep
Deploy DICOM service using Azure portal https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/deploy-dicom-services-in-azure
Deploy DICOM service backed by Azure Data Lake Storage https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/deploy-dicom-services-in-azure-data-lake
Deploy FHIR service via Azure portal https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/deploy-azure-portal
Check Azure Health Data Services regional availability https://learn.microsoft.com/en-us/azure/healthcare-apis/services-features-regional-availability