Microsoft Purview Accounts API

Operations for managing Purview accounts

Documentation GitHub OpenAPI

Business capability

Operations 9

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Purview/accounts/{accountName} Create or replace a Purview account · Microsoft Purview Create or update a Purview account #

Ask an LLM

“How do I provision a new Microsoft Purview account in a resource group?”

“Can I set the region, SKU and tags when I create a Purview account?”

Tell an agent

Create a Purview account named {account} in resource group {rg} of subscription {sub} in {location}.

Provision Purview account {account} in {rg} with SKU {sku}.

GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Purview/accounts/{accountName} Get a Purview account's details · Microsoft Purview Get a Purview account #

Ask an LLM

“What are the current settings and SKU of my Purview account?”

“Where can I see the location and identity of an existing Purview account?”

Tell an agent

Show me Purview account {account} in resource group {rg} of subscription {sub}.

Fetch the properties of the {account} Purview account in {rg}.

PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Purview/accounts/{accountName} Patch tags or properties on a Purview account · Microsoft Purview Update a Purview account #

Ask an LLM

“How do I change only the tags on an existing Purview account without recreating it?”

“Can I patch the managed identity of a Purview account in place?”

Tell an agent

Update the tags on Purview account {account} in {rg} of subscription {sub} to {tags}.

Patch the identity of existing Purview account {account} in {rg} to {identity}.

DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Purview/accounts/{accountName} Delete a Purview account · Microsoft Purview Delete a Purview account #

Ask an LLM

“Can I permanently remove a Purview account I no longer use?”

“What happens when I tear down a Purview account resource?”

Tell an agent destructive · confirm first

Delete Purview account {account} from resource group {rg} in subscription {sub}.

Remove the {account} Purview account in {rg}.

GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Purview/accounts List Purview accounts in a resource group · Microsoft Purview List accounts by resource group #

Ask an LLM

“Which Purview accounts live in a particular resource group?”

“How many Purview accounts does one resource group hold?”

Tell an agent

List the Purview accounts in resource group {rg} of subscription {sub}.

Get the next page of Purview accounts in {rg} using skip token {skip}.

GET /subscriptions/{subscriptionId}/providers/Microsoft.Purview/accounts List Purview accounts across a subscription · Microsoft Purview List accounts by subscription #

Ask an LLM

“What Purview accounts exist anywhere in my Azure subscription?”

“Can I see every Purview account in a subscription regardless of resource group?”

Tell an agent

List all Purview accounts in subscription {sub}.

Continue listing subscription {sub}'s Purview accounts from skip token {skip}.

POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Purview/accounts/{accountName}/listkeys Retrieve a Purview account's access keys · Microsoft Purview List account keys #

Ask an LLM

“Where do I get the Atlas Kafka endpoint keys for my Purview account?”

“How can I read the access keys of a Purview account?”

Tell an agent

Get the access keys for Purview account {account} in {rg} of subscription {sub}.

Retrieve the keys of the {account} Purview account.

POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Purview/accounts/{accountName}/addRootCollectionAdmin Add an admin to the root collection · Microsoft Purview Add root collection admin #

Ask an LLM

“How do I grant someone admin rights on a Purview account's root collection?”

“Can I add a collection administrator by their Entra object ID?”

Tell an agent

Make object ID {object} an admin of the root collection on Purview account {account} in {rg} of subscription {sub}.

Add {object} as root collection administrator for {account}.

POST /subscriptions/{subscriptionId}/providers/Microsoft.Purview/checkNameAvailability Check whether a Purview account name is free · Microsoft Purview Check name availability #

Ask an LLM

“Is a given Purview account name already taken?”

“Can I verify a name is available before creating a Purview account?”

Tell an agent

Check if the Purview account name {name} is available in subscription {sub}.

Tell me whether {name} can be used as a new Purview account name.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/microsoft-purview:microsoft-purview-accounts-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Microsoft Purview Account Accounts API
  description: APIs for managing Purview accounts, configurations, and administrative settings through Azure Resource Manager. Provides resource management operations for creating, updating, and deleting Purview accounts.
  version: 2021-12-01
  contact:
    name: Microsoft Purview Support
    url: https://learn.microsoft.com/en-us/purview/
  license:
    name: Microsoft API License
    url: https://azure.microsoft.com/en-us/support/legal/
servers:
- url: https://management.azure.com
  description: Azure Resource Manager endpoint
security:
- oauth2: []
tags:
- name: Accounts
  description: Operations for managing Purview accounts
paths:
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Purview/accounts/{accountName}:
    put:
      operationId: createOrUpdateAccount
      summary: Microsoft Purview Create or update a Purview account
      description: Create or update an account resource in the specified resource group.
      tags:
      - Accounts
      parameters:
      - $ref: '#/components/parameters/SubscriptionId'
      - $ref: '#/components/parameters/ResourceGroupName'
      - $ref: '#/components/parameters/AccountName'
      - $ref: '#/components/parameters/ApiVersion'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Account'
      responses:
        '200':
          description: Account updated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Account'
        '201':
          description: Account creation initiated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Account'
        '400':
          description: Bad request
        '401':
          description: Unauthorized
    get:
      operationId: getAccount
      summary: Microsoft Purview Get a Purview account
      description: Gets the account resource for a given account name.
      tags:
      - Accounts
      parameters:
      - $ref: '#/components/parameters/SubscriptionId'
      - $ref: '#/components/parameters/ResourceGroupName'
      - $ref: '#/components/parameters/AccountName'
      - $ref: '#/components/parameters/ApiVersion'
      responses:
        '200':
          description: Account retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Account'
        '401':
          description: Unauthorized
        '404':
          description: Account not found
    patch:
      operationId: updateAccount
      summary: Microsoft Purview Update a Purview account
      description: Patches the account resource with the given properties.
      tags:
      - Accounts
      parameters:
      - $ref: '#/components/parameters/SubscriptionId'
      - $ref: '#/components/parameters/ResourceGroupName'
      - $ref: '#/components/parameters/AccountName'
      - $ref: '#/components/parameters/ApiVersion'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountUpdateParameters'
      responses:
        '200':
          description: Account updated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Account'
        '202':
          description: Account update accepted
        '401':
          description: Unauthorized
    delete:
      operationId: deleteAccount
      summary: Microsoft Purview Delete a Purview account
      description: Deletes the account resource.
      tags:
      - Accounts
      parameters:
      - $ref: '#/components/parameters/SubscriptionId'
      - $ref: '#/components/parameters/ResourceGroupName'
      - $ref: '#/components/parameters/AccountName'
      - $ref: '#/components/parameters/ApiVersion'
      responses:
        '200':
          description: Account deleted successfully
        '202':
          description: Account deletion accepted
        '204':
          description: Account not found
        '401':
          description: Unauthorized
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Purview/accounts:
    get:
      operationId: listAccountsByResourceGroup
      summary: Microsoft Purview List accounts by resource group
      description: Gets the accounts resources by resource group.
      tags:
      - Accounts
      parameters:
      - $ref: '#/components/parameters/SubscriptionId'
      - $ref: '#/components/parameters/ResourceGroupName'
      - $ref: '#/components/parameters/ApiVersion'
      - name: $skipToken
        in: query
        description: The skip token for pagination
        schema:
          type: string
      responses:
        '200':
          description: Accounts listed successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountList'
        '401':
          description: Unauthorized
  /subscriptions/{subscriptionId}/providers/Microsoft.Purview/accounts:
    get:
      operationId: listAccountsBySubscription
      summary: Microsoft Purview List accounts by subscription
      description: Gets the accounts resources by subscription.
      tags:
      - Accounts
      parameters:
      - $ref: '#/components/parameters/SubscriptionId'
      - $ref: '#/components/parameters/ApiVersion'
      - name: $skipToken
        in: query
        description: The skip token for pagination
        schema:
          type: string
      responses:
        '200':
          description: Accounts listed successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountList'
        '401':
          description: Unauthorized
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Purview/accounts/{accountName}/listkeys
  : post:
      operationId: listAccountKeys
      summary: Microsoft Purview List account keys
      description: Lists the keys asynchronous for the Purview account.
      tags:
      - Accounts
      parameters:
      - $ref: '#/components/parameters/SubscriptionId'
      - $ref: '#/components/parameters/ResourceGroupName'
      - $ref: '#/components/parameters/AccountName'
      - $ref: '#/components/parameters/ApiVersion'
      responses:
        '200':
          description: Keys retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessKeys'
        '401':
          description: Unauthorized
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Purview/accounts/{accountName}/addRootCollectionAdmin
  : post:
      operationId: addRootCollectionAdmin
      summary: Microsoft Purview Add root collection admin
      description: Add the administrator for root collection associated with this account.
      tags:
      - Accounts
      parameters:
      - $ref: '#/components/parameters/SubscriptionId'
      - $ref: '#/components/parameters/ResourceGroupName'
      - $ref: '#/components/parameters/AccountName'
      - $ref: '#/components/parameters/ApiVersion'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CollectionAdminUpdate'
      responses:
        '200':
          description: Admin added successfully
        '401':
          description: Unauthorized
  /subscriptions/{subscriptionId}/providers/Microsoft.Purview/checkNameAvailability:
    post:
      operationId: checkNameAvailability
      summary: Microsoft Purview Check name availability
      description: Checks the account name availability for the given subscription.
      tags:
      - Accounts
      parameters:
      - $ref: '#/components/parameters/SubscriptionId'
      - $ref: '#/components/parameters/ApiVersion'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CheckNameAvailabilityRequest'
      responses:
        '200':
          description: Name availability check completed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckNameAvailabilityResult'
        '401':
          description: Unauthorized
components:
  schemas:
    Identity:
      type: object
      properties:
        principalId:
          type: string
          readOnly: true
        tenantId:
          type: string
          readOnly: true
        type:
          type: string
          enum:
          - None
          - SystemAssigned
          - UserAssigned
        userAssignedIdentities:
          type: object
          additionalProperties:
            type: object
            properties:
              clientId:
                type: string
              principalId:
                type: string
    CheckNameAvailabilityRequest:
      type: object
      properties:
        name:
          type: string
        type:
          type: string
    AccountUpdateParameters:
      type: object
      properties:
        identity:
          $ref: '#/components/schemas/Identity'
        properties:
          type: object
          properties:
            managedResourceGroupName:
              type: string
            publicNetworkAccess:
              type: string
              enum:
              - NotSpecified
              - Enabled
              - Disabled
        tags:
          type: object
          additionalProperties:
            type: string
    AccountList:
      type: object
      properties:
        value:
          type: array
          items:
            $ref: '#/components/schemas/Account'
        nextLink:
          type: string
        count:
          type: integer
          format: int64
    CheckNameAvailabilityResult:
      type: object
      properties:
        message:
          type: string
        nameAvailable:
          type: boolean
        reason:
          type: string
          enum:
          - Invalid
          - AlreadyExists
    AccessKeys:
      type: object
      properties:
        atlasKafkaPrimaryEndpoint:
          type: string
        atlasKafkaSecondaryEndpoint:
          type: string
    Account:
      type: object
      description: A Microsoft Purview account resource
      properties:
        id:
          type: string
          readOnly: true
        identity:
          $ref: '#/components/schemas/Identity'
        location:
          type: string
        name:
          type: string
          readOnly: true
        properties:
          $ref: '#/components/schemas/AccountProperties'
        sku:
          $ref: '#/components/schemas/AccountSku'
        tags:
          type: object
          additionalProperties:
            type: string
        type:
          type: string
          readOnly: true
    CollectionAdminUpdate:
      type: object
      properties:
        objectId:
          type: string
    AccountEndpoints:
      type: object
      readOnly: true
      properties:
        catalog:
          type: string
        guardian:
          type: string
        scan:
          type: string
    PrivateEndpointConnection:
      type: object
      properties:
        id:
          type: string
          readOnly: true
        name:
          type: string
          readOnly: true
        properties:
          type: object
          properties:
            privateEndpoint:
              type: object
              properties:
                id:
                  type: string
            privateLinkServiceConnectionState:
              type: object
              properties:
                actionsRequired:
                  type: string
                description:
                  type: string
                status:
                  type: string
                  enum:
                  - Unknown
                  - Pending
                  - Approved
                  - Rejected
                  - Disconnected
            provisioningState:
              type: string
              readOnly: true
        type:
          type: string
          readOnly: true
    AccountProperties:
      type: object
      properties:
        cloudConnectors:
          type: object
          properties:
            awsExternalId:
              type: string
              readOnly: true
        createdAt:
          type: string
          format: date-time
          readOnly: true
        createdBy:
          type: string
          readOnly: true
        createdByObjectId:
          type: string
          readOnly: true
        endpoints:
          $ref: '#/components/schemas/AccountEndpoints'
        friendlyName:
          type: string
          readOnly: true
        managedResourceGroupName:
          type: string
        managedResources:
          type: object
          readOnly: true
          properties:
            eventHubNamespace:
              type: string
            resourceGroup:
              type: string
            storageAccount:
              type: string
        privateEndpointConnections:
          type: array
          readOnly: true
          items:
            $ref: '#/components/schemas/PrivateEndpointConnection'
        provisioningState:
          type: string
          readOnly: true
          enum:
          - Unknown
          - Creating
          - Moving
          - Deleting
          - SoftDeleting
          - SoftDeleted
          - Failed
          - Succeeded
          - Canceled
        publicNetworkAccess:
          type: string
          enum:
          - NotSpecified
          - Enabled
          - Disabled
    AccountSku:
      type: object
      properties:
        capacity:
          type: integer
          format: int32
        name:
          type: string
          enum:
          - Standard
  parameters:
    ResourceGroupName:
      name: resourceGroupName
      in: path
      required: true
      description: The resource group name
      schema:
        type: string
    AccountName:
      name: accountName
      in: path
      required: true
      description: The name of the Purview account
      schema:
        type: string
    SubscriptionId:
      name: subscriptionId
      in: path
      required: true
      description: The Azure subscription ID
      schema:
        type: string
        format: uuid
    ApiVersion:
      name: api-version
      in: query
      required: true
      description: The API version
      schema:
        type: string
        default: '2021-12-01'
  securitySchemes:
    oauth2:
      type: oauth2
      description: Azure Active Directory OAuth2 authentication
      flows:
        clientCredentials:
          tokenUrl: https://login.microsoftonline.com/{tenantId}/oauth2/v2.0/token
          scopes:
            https://management.azure.com/.default: Access Azure Resource Manager

Microsoft Purview Accounts API

Operations 9

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification