Microsoft Entra ID (formerly Azure AD)

Microsoft Entra ID (formerly Azure AD) Directory.recovery API

The directory.recovery API from Microsoft Entra ID (formerly Azure AD) — 14 operation(s) for directory.recovery.

GitHub OpenAPI

Operations 22

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 /directory/recovery Get the directory recovery settings · Get recovery from directory #
Ask an LLM
“What does the directory recovery resource in Microsoft Entra contain?”
“Can I see the recovery setup for my directory, including its jobs and snapshots?”
Tell an agent
Show the directory recovery resource.
Get the recovery configuration for my directory.
PATCH /directory/recovery Update the directory recovery resource · Update the navigation property recovery in directory #
Ask an LLM
“How do I change the directory recovery resource as a whole?”
“Can I patch the recovery object that holds my jobs and snapshots?”
Tell an agent
Update the directory recovery resource.
Replace the list of recovery jobs on the directory recovery object with {jobs}.
DELETE /directory/recovery Delete the directory recovery resource · Delete navigation property recovery for directory #
Ask an LLM
“Is it possible to delete the whole recovery resource from the directory?”
“What happens if I remove the directory recovery navigation property?”
Tell an agent destructive · confirm first
Delete the directory recovery resource.
Remove the recovery object from the directory entirely.
GET /directory/recovery/jobs List directory recovery jobs · Get jobs from directory #
Ask an LLM
“Which recovery jobs have been run against my directory?”
“Can I see the status of all directory restore jobs?”
Tell an agent
List all directory recovery jobs.
Show every recovery job with its status and start time.
POST /directory/recovery/jobs Start a directory recovery job · Create new navigation property to jobs for directory #
Ask an LLM
“How do I start a job to restore directory objects to an earlier state?”
“Can I limit a recovery job with filtering criteria?”
Tell an agent
Create a recovery job that restores the directory to its state at {target_time}.
Start a recovery job targeting {target_time} using filtering criteria {criteria}.
GET /directory/recovery/jobs/{recoveryJobBase-id} Get a directory recovery job · Get jobs from directory #
Ask an LLM
“What's the status of a specific directory recovery job?”
“How many objects did a given recovery job calculate as changed?”
Tell an agent
Get recovery job {job_id}.
Show the status and completion time of recovery job {job_id}.
PATCH /directory/recovery/jobs/{recoveryJobBase-id} Update a directory recovery job · Update the navigation property jobs in directory #
Ask an LLM
“Can I change the target restore time on an existing recovery job?”
“How do I edit the filtering criteria of a recovery job I already created?”
Tell an agent
Change the target state time of recovery job {job_id} to {target_time}.
Update the filtering criteria on recovery job {job_id} to {criteria}.
DELETE /directory/recovery/jobs/{recoveryJobBase-id} Delete a directory recovery job · Delete navigation property jobs for directory #
Ask an LLM
“How do I delete an old directory recovery job record?”
“Can a recovery job entry be removed after it finishes?”
Tell an agent destructive · confirm first
Delete recovery job {job_id}.
Remove the recovery job record {job_id} from the directory.
POST /directory/recovery/jobs/{recoveryJobBase-id}/microsoft.graph.entraRecoveryServices.cancel Cancel a running directory recovery job · Invoke action cancel #
Ask an LLM
“How do I stop a directory recovery job that's still running?”
“Can I abort a restore job partway through?”
Tell an agent destructive · confirm first
Cancel recovery job {job_id}.
Abort the in-progress directory restore job {job_id}.
GET /directory/recovery/jobs/$count Count directory recovery jobs · Get the number of the resource #
Ask an LLM
“How many recovery jobs exist for my directory?”
“What's the total number of restore jobs we've run?”
Tell an agent
Count the directory recovery jobs.
Tell me how many recovery jobs there are.
GET /directory/recovery/snapshots List directory recovery snapshots · Get snapshots from directory #
Ask an LLM
“Which backup snapshots of my directory are available to restore from?”
“Can I see when each directory snapshot was taken?”
Tell an agent
List all directory recovery snapshots.
Show every snapshot with its creation time and number of changed objects.
POST /directory/recovery/snapshots Create a directory recovery snapshot · Create new navigation property to snapshots for directory #
Ask an LLM
“How do I add a new snapshot record to directory recovery?”
“Can I create a snapshot entry through the API?”
Tell an agent
Create a new directory recovery snapshot.
Add a recovery snapshot dated {created_time}.
GET /directory/recovery/snapshots/{snapshot-id} Get a directory recovery snapshot · Get snapshots from directory #
Ask an LLM
“What does a particular directory snapshot contain?”
“How many objects changed in a given recovery snapshot?”
Tell an agent
Get recovery snapshot {snapshot_id}.
Show the creation time and changed object count of snapshot {snapshot_id}.
PATCH /directory/recovery/snapshots/{snapshot-id} Update a directory recovery snapshot · Update the navigation property snapshots in directory #
Ask an LLM
“Can I edit the properties of an existing directory snapshot?”
“How do I change the recorded changed-object total on a snapshot?”
Tell an agent
Update recovery snapshot {snapshot_id}.
Set the total changed objects on snapshot {snapshot_id} to {total}.
DELETE /directory/recovery/snapshots/{snapshot-id} Delete a directory recovery snapshot · Delete navigation property snapshots for directory #
Ask an LLM
“How do I delete a directory snapshot we no longer need?”
“Can I remove a recovery snapshot permanently?”
Tell an agent destructive · confirm first
Delete recovery snapshot {snapshot_id}.
Remove directory snapshot {snapshot_id}.
GET /directory/recovery/snapshots/{snapshot-id}/recoveryJobs List recovery jobs run from a snapshot · Get recoveryJobs from directory #
Ask an LLM
“Which restore jobs were run from a particular snapshot?”
“Has anyone actually restored from this directory snapshot?”
Tell an agent
List the recovery jobs for snapshot {snapshot_id}.
Show every restore job that used snapshot {snapshot_id}.
GET /directory/recovery/snapshots/{snapshot-id}/recoveryJobs/{recoveryJob-id} Get a recovery job belonging to a snapshot · Get recoveryJobs from directory #
Ask an LLM
“What's the status of one restore job run from a given snapshot?”
“Can I look up a snapshot's recovery job by its id?”
Tell an agent
Get recovery job {job_id} of snapshot {snapshot_id}.
Show the progress of restore job {job_id} started from snapshot {snapshot_id}.
GET /directory/recovery/snapshots/{snapshot-id}/recoveryJobs/$count Count recovery jobs run from a snapshot · Get the number of the resource #
Ask an LLM
“How many restore jobs have used a particular snapshot?”
“What's the number of recovery jobs tied to this snapshot?”
Tell an agent
Count the recovery jobs for snapshot {snapshot_id}.
Tell me how many restore jobs ran from snapshot {snapshot_id}.
GET /directory/recovery/snapshots/{snapshot-id}/recoveryPreviewJobs List recovery preview jobs for a snapshot · Get recoveryPreviewJobs from directory #
Ask an LLM
“Which preview jobs have been run to see what restoring a snapshot would change?”
“Can I list the dry-run previews for a directory snapshot?”
Tell an agent
List the dry-run preview jobs for snapshot {snapshot_id}.
Show every restore preview run against snapshot {snapshot_id}.
GET /directory/recovery/snapshots/{snapshot-id}/recoveryPreviewJobs/{recoveryPreviewJob-id} Get a recovery preview job for a snapshot · Get recoveryPreviewJobs from directory #
Ask an LLM
“What did a specific restore preview report for a snapshot?”
“Can I check the results of one recovery preview job by id?”
Tell an agent
Get recovery preview job {preview_id} of snapshot {snapshot_id}.
Show the preview results of job {preview_id} for snapshot {snapshot_id}.
GET /directory/recovery/snapshots/{snapshot-id}/recoveryPreviewJobs/$count Count recovery preview jobs for a snapshot · Get the number of the resource #
Ask an LLM
“How many restore previews have been run on a snapshot?”
“What's the count of preview jobs attached to this snapshot?”
Tell an agent
Count the dry-run previews run on snapshot {snapshot_id}.
Tell me how many restore previews ran on snapshot {snapshot_id}.
GET /directory/recovery/snapshots/$count Count directory recovery snapshots · Get the number of the resource #
Ask an LLM
“How many directory snapshots are available?”
“What's the total number of recovery snapshots we have?”
Tell an agent
Count the directory recovery snapshots.
Tell me how many snapshots exist for directory recovery.

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/graph/api/overview
📖
Authentication
https://learn.microsoft.com/en-us/graph/auth/
📖
Documentation
https://learn.microsoft.com/en-us/graph/change-notifications-overview

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/openapi/azure-ad-directory-recovery-api-openapi.yml

Other Resources

🔗
SDKs
https://learn.microsoft.com/en-us/graph/sdks/sdks-overview
🔗
ChangeLog
https://developer.microsoft.com/en-us/graph/changelog
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/asyncapi/azure-ad-change-notifications-webhooks.yml

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/azure-ad:azure-ad-directory-recovery-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

azure-ad-directory-recovery-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Identity.DirectoryManagement Directory.recovery API
  version: v1.0
servers:
- url: https://graph.microsoft.com/v1.0/
  description: Core
security:
- azureaadv2: []
tags:


# --- truncated at 32 KB (34 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/openapi/azure-ad-directory-recovery-api-openapi.yml