Azure Data Factory

Azure Data Factory Factories API

Factories operations on the Microsoft.DataFactory resource provider (9 operations): Factories_List, Factories_ConfigureFactoryRepo, Factories_ListByResourceGroup, Factories_Get, Factories_CreateOrUpdate, Factories_Update, and more.

GitHub OpenAPI

Operations 13

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

GET /subscriptions/{subscriptionId}/providers/Microsoft.DataFactory/factories List every data factory in my subscription · Factories list #
Ask an LLM
“Which data factories exist across my whole Azure subscription?”
“Can I list factories subscription-wide instead of one resource group at a time?”
Tell an agent
List all data factories in my subscription.
Show every Data Factory across the subscription, regardless of resource group.
POST /subscriptions/{subscriptionId}/providers/Microsoft.DataFactory/locations/{locationId}/configureFactoryRepo Set a factory's git repository configuration · Factories configure factory repo #
Ask an LLM
“How do I connect my data factory to a git repo for source control?”
“Can I change which repository and branch a factory is linked to?”
Tell an agent
Configure the git repo for factory {factoryId} in location {location} with {repo}.
Link factory resource {factoryId} to repository settings {repo}.
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories List data factories in a resource group · Factories list by resource group #
Ask an LLM
“Which data factories live in my current resource group?”
“What factories are deployed in this one resource group?”
Tell an agent
List the data factories in this resource group.
Show me the factories scoped to my resource group only.
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName} Get a data factory · Factories get #
Ask an LLM
“How do I look up the details of one data factory, like its identity and repo settings?”
“Can I skip re-downloading a factory's details if its ETag hasn't changed?”
Tell an agent
Get data factory {factory}.
Fetch factory {factory} unless it still matches ETag {etag}.
PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName} Create or update a data factory · Factories create or update #
Ask an LLM
“How do I create a new Azure Data Factory instance through the API?”
“Can I set a managed identity and tags when I create a factory?”
Tell an agent
Create data factory {factory} in {location}.
Create or replace factory {factory} in {location} with identity {identity} and tags {tags}.
PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName} Patch a factory's tags or identity · Factories update #
Ask an LLM
“Can I change just the tags on a data factory without resending its full definition?”
“How do I patch a factory's managed identity in place?”
Tell an agent
Update the tags on factory {factory} to {tags}.
Patch the identity of factory {factory} to {identity}.
DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName} Delete a data factory · Factories delete #
Ask an LLM
“Can I delete an entire data factory, including everything in it?”
“What is the call to tear down a data factory I no longer use?”
Tell an agent destructive · confirm first
Delete data factory {factory}.
Tear down the {factory} factory for good.
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/getDataPlaneAccess Get a data plane access token for a factory · Factories get data plane access #
Ask an LLM
“How do I get a time-limited data plane access token for my data factory?”
“Can I request data plane access with specific permissions and an expiry time?”
Tell an agent
Get data plane access for factory {factory} with permissions {permissions}.
Request data plane access to {path} on {factory} from {start} until {expire}.
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/getGitHubAccessToken Exchange a GitHub code for an access token · Factories get git hub access token #
Ask an LLM
“How do I get a GitHub access token so my data factory can use a GitHub repo?”
“Can I trade a GitHub OAuth access code for a token through the factory?”
Tell an agent
Get a GitHub access token for factory {factory} using code {code} at {baseUrl}.
Exchange GitHub access code {code} with client ID {client} via token URL {baseUrl}.
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{name} Get a factory by resource group and name · Azure Data Factory REST API Get resource #
Ask an LLM
“Can I fetch a data factory resource by naming both its resource group and its name?”
“What does the generic resource read return for a factory in a named resource group?”
Tell an agent
Get the factories resource {name} in resource group {group} of subscription {sub}.
Read factory resource {name} from resource group {group} using the generic resource call.
PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{name} Create or update a factory in a named resource group · Azure Data Factory REST API Create or update resource #
Ask an LLM
“Can I create a factory resource by passing its resource group and name explicitly?”
“Which fields go into the generic create-or-update call for a factories resource?”
Tell an agent
Create factories resource {name} in group {group}, subscription {sub}, in {location}.
Put factories resource {name} in group {group} with properties {properties} and tags {tags}.
PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{name} Update a factory in a named resource group · Azure Data Factory REST API Update resource #
Ask an LLM
“Can I patch a factories resource addressed by resource group and name?”
“Is there a generic PATCH for a factory resource in a given resource group?”
Tell an agent
Update factories resource {name} in resource group {group} of subscription {sub}.
Patch the {name} factories resource in group {group} using the generic update call.
DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{name} Delete a factory in a named resource group · Azure Data Factory REST API Delete resource #
Ask an LLM
“Can I delete a factory resource by giving its resource group and name?”
“What does the generic delete call remove for a factories resource?”
Tell an agent destructive · confirm first
Delete factories resource {name} in resource group {group} of subscription {sub}.
Remove the {name} factories resource from group {group} via the generic resource call.

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/azure/data-factory/
📖
APIReference
https://learn.microsoft.com/en-us/rest/api/datafactory/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-data-factory/refs/heads/main/openapi/microsoft-azure-data-factory-factories-api-openapi.yml
⚙
OpenAPI
https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/datafactory/resource-manager/Microsoft.DataFactory/DataFactory/stable/2018-06-01/openapi.json

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-data-factory/refs/heads/main/overlays/microsoft-azure-data-factory-factories-api-overlay.yaml

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-azure-data-factory:microsoft-azure-data-factory-factories-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

microsoft-azure-data-factory-factories-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Microsoft Azure Data Factory Factories API
  x-refined-note:
  - x-typespec-generated differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged factories across 2 of this provider''s published API definitions: microsoft-azure-data-factory-datafactory-2018-06-01-swagger.json, microsoft-azure-data-factory-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://management.azure.com
security:
- azure_auth:
  - user_impersonation
tags:


# --- truncated at 32 KB (32 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure-data-factory/refs/heads/main/openapi/microsoft-azure-data-factory-factories-api-openapi.yml