Microsoft Entra ID (formerly Azure AD) Identity Governance.terms Of Use Container API

The identityGovernance.termsOfUseContainer API from Microsoft Entra ID (formerly Azure AD) — 23 operation(s) for identitygovernance.termsofusecontainer.

Operations 48

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 /identityGovernance/termsOfUse Get the terms of use container · Get termsOfUse from identityGovernance #
Ask an LLM
“How do I read the top-level terms of use container in identity governance?”
“Can I expand the agreements when fetching the terms of use container?”
Tell an agent
Get the identity governance terms of use container.
Show the terms of use container with {expand} expanded.
PATCH /identityGovernance/termsOfUse Update the terms of use container · Update the navigation property termsOfUse in identityGovernance #
Ask an LLM
“How do I update the terms of use container itself rather than a single agreement?”
“Can I replace the set of agreements held in the terms of use container in one patch?”
Tell an agent
Update the terms of use container with agreements {agreements}.
Patch the terms of use container's agreement acceptances to {agreementAcceptances}.
DELETE /identityGovernance/termsOfUse Delete the terms of use container · Delete navigation property termsOfUse for identityGovernance #
Ask an LLM
“What happens if I delete the whole terms of use container from identity governance?”
“Can I remove the terms of use container only if its ETag still matches?”
Tell an agent destructive · confirm first
Delete the entire terms of use container.
Delete the terms of use container if its ETag is {ifMatch}.
GET /identityGovernance/termsOfUse/agreementAcceptances List all terms of use acceptances tenant-wide · Get agreementAcceptances from identityGovernance #
Ask an LLM
“Which users have accepted or declined any terms of use across the whole tenant?”
“Can I filter tenant-wide terms of use responses by user email or state?”
Tell an agent
List every terms of use acceptance record across the tenant.
List tenant-wide agreement acceptances matching {filter}.
POST /identityGovernance/termsOfUse/agreementAcceptances Record a tenant-level agreement acceptance · Create new navigation property to agreementAcceptances for identityGovernance #
Ask an LLM
“Can I add an acceptance record to the tenant-wide agreement acceptances collection?”
“What fields go into a new terms of use acceptance record, like device and user details?”
Tell an agent
Record a tenant-level acceptance of agreement {agreementId} by user {userPrincipalName} with state {state}.
Add a tenant-wide acceptance for user {userId} on device {deviceDisplayName}.
GET /identityGovernance/termsOfUse/agreementAcceptances/{agreementAcceptance-id} Get a tenant-level agreement acceptance · Get agreementAcceptances from identityGovernance #
Ask an LLM
“How do I look up one acceptance record from the tenant-wide terms of use acceptances?”
“When does a particular user's terms of use acceptance expire?”
Tell an agent
Get tenant-level agreement acceptance {agreementAcceptance}.
Show the state and expiry of tenant-wide acceptance {agreementAcceptance}.
PATCH /identityGovernance/termsOfUse/agreementAcceptances/{agreementAcceptance-id} Update a tenant-level agreement acceptance · Update the navigation property agreementAcceptances in identityGovernance #
Ask an LLM
“Is it possible to change the state of an acceptance in the tenant-wide acceptances collection?”
“How do I update the expiration date on a tenant-level terms of use acceptance?”
Tell an agent
Set state {state} on tenant-level agreement acceptance {agreementAcceptance}.
Change the expiry of tenant-wide acceptance {agreementAcceptance} to {expirationDateTime}.
DELETE /identityGovernance/termsOfUse/agreementAcceptances/{agreementAcceptance-id} Delete a tenant-level agreement acceptance · Delete navigation property agreementAcceptances for identityGovernance #
Ask an LLM
“Can I remove a record from the tenant-wide agreement acceptances collection?”
“How do I delete a user's terms of use response stored at the tenant level?”
Tell an agent destructive · confirm first
Delete tenant-level agreement acceptance {agreementAcceptance}.
Remove tenant-wide acceptance record {agreementAcceptance}.
GET /identityGovernance/termsOfUse/agreementAcceptances/$count Count tenant-wide agreement acceptances · Get the number of the resource #
Ask an LLM
“How many terms of use acceptance records exist across the whole tenant?”
“What's the count of tenant-wide acceptances that match a filter like declined state?”
Tell an agent
Count all tenant-level agreement acceptances.
Count tenant-wide agreement acceptances matching {filter}.
GET /identityGovernance/termsOfUse/agreements List terms of use agreements · List agreements #
Ask an LLM
“What terms of use agreements have we set up in Microsoft Entra ID?”
“Can I search our terms of use agreements by display name?”
Tell an agent
List all terms of use agreements.
List terms of use agreements matching {filter}.
POST /identityGovernance/termsOfUse/agreements Create a terms of use agreement · Create agreement #
Ask an LLM
“How do I publish a new terms of use agreement that users must accept?”
“Can I require users to open the terms before they're allowed to accept them?”
Tell an agent
Create a terms of use agreement called {displayName}.
Create agreement {displayName} requiring viewing before acceptance set to {isViewingBeforeAcceptanceRequired}.
GET /identityGovernance/termsOfUse/agreements/{agreement-id} Get a terms of use agreement · Get agreement #
Ask an LLM
“How do I see the settings of one terms of use agreement?”
“Does a specific agreement require per-device acceptance?”
Tell an agent
Get terms of use agreement {agreement}.
Show the acceptance settings of agreement {agreement}.
PATCH /identityGovernance/termsOfUse/agreements/{agreement-id} Update a terms of use agreement · Update agreement #
Ask an LLM
“How do I rename an existing terms of use agreement?”
“Can I change how often users must re-accept an agreement that's already published?”
Tell an agent
Rename agreement {agreement} to {displayName}.
Set per-device acceptance to {isPerDeviceAcceptanceRequired} on existing agreement {agreement}.
DELETE /identityGovernance/termsOfUse/agreements/{agreement-id} Delete a terms of use agreement · Delete agreement #
Ask an LLM
“Can I retire and delete a terms of use agreement we no longer use?”
“How do I remove a terms of use agreement from the tenant?”
Tell an agent destructive · confirm first
Delete terms of use agreement {agreement}.
Remove agreement {agreement} from the tenant.
GET /identityGovernance/termsOfUse/agreements/{agreement-id}/acceptances List acceptances for one agreement · List acceptances #
Ask an LLM
“Who has accepted a specific terms of use agreement?”
“Can I filter one agreement's acceptance records to users who declined?”
Tell an agent
List the acceptance records for agreement {agreement}.
List acceptances of agreement {agreement} matching {filter}.
POST /identityGovernance/termsOfUse/agreements/{agreement-id}/acceptances Add an acceptance to a specific agreement · Create new navigation property to acceptances for identityGovernance #
Ask an LLM
“Can I add an acceptance record directly under one terms of use agreement?”
“How would I log that a user accepted a particular agreement on their device?”
Tell an agent
Add an acceptance by user {userPrincipalName} to agreement {agreement}.
Record state {state} for user {userId} under agreement {agreement}.
GET /identityGovernance/termsOfUse/agreements/{agreement-id}/acceptances/{agreementAcceptance-id} Get one acceptance of a specific agreement · Get acceptances from identityGovernance #
Ask an LLM
“How do I read a single acceptance record under a given agreement?”
“Which device was used for one particular acceptance of this agreement?”
Tell an agent
Get acceptance {agreementAcceptance} of agreement {agreement}.
Show the device and state for acceptance {agreementAcceptance} under agreement {agreement}.
PATCH /identityGovernance/termsOfUse/agreements/{agreement-id}/acceptances/{agreementAcceptance-id} Update an acceptance on a specific agreement · Update the navigation property acceptances in identityGovernance #
Ask an LLM
“How do I change the state of one acceptance record under a given agreement?”
“Can I update the expiry of an acceptance stored under a particular agreement?”
Tell an agent
Set state {state} on acceptance {agreementAcceptance} of agreement {agreement}.
Change expiry of acceptance {agreementAcceptance} under agreement {agreement} to {expirationDateTime}.
DELETE /identityGovernance/termsOfUse/agreements/{agreement-id}/acceptances/{agreementAcceptance-id} Delete an acceptance from a specific agreement · Delete navigation property acceptances for identityGovernance #
Ask an LLM
“Can I remove one acceptance record from a particular agreement?”
“How do I delete a user's acceptance under a given terms of use agreement?”
Tell an agent destructive · confirm first
Delete acceptance {agreementAcceptance} from agreement {agreement}.
Remove the acceptance record {agreementAcceptance} under agreement {agreement}.
GET /identityGovernance/termsOfUse/agreements/{agreement-id}/acceptances/$count Count acceptances of one agreement · Get the number of the resource #
Ask an LLM
“How many people have responded to a specific terms of use agreement?”
“What's the number of acceptances for one agreement that match a filter?”
Tell an agent
Count the acceptances of agreement {agreement}.
Count acceptances under agreement {agreement} matching {filter}.
GET /identityGovernance/termsOfUse/agreements/{agreement-id}/file Get the default file of a terms of use agreement · Get agreementFile #
Ask an LLM
“What language and version details does the main file of a terms of use agreement carry?”
“Can I read an agreement's current default file rather than the old files collection?”
Tell an agent
Get the default agreement file for terms of use agreement {agreement}.
Show the language and version info of {agreement}'s main agreement file.
PATCH /identityGovernance/termsOfUse/agreements/{agreement-id}/file Update the default file of an agreement · Update the navigation property file in identityGovernance #
Ask an LLM
“How do I replace the translations held on an agreement's default file in one update?”
“Can I patch the main agreement file rather than a single translation of it?”
Tell an agent
Update the default agreement file on terms of use agreement {agreement}.
Set the localizations of {agreement}'s main file to {localizations}.
DELETE /identityGovernance/termsOfUse/agreements/{agreement-id}/file Remove the default file from an agreement · Delete navigation property file for identityGovernance #
Ask an LLM
“Can I delete the main file property of a terms of use agreement entirely?”
“What happens if I remove an agreement's default file instead of one translation?”
Tell an agent destructive · confirm first
Delete the default agreement file from terms of use agreement {agreement}.
Remove {agreement}'s main file only if its ETag still matches {etag}.
GET /identityGovernance/termsOfUse/agreements/{agreement-id}/file/localizations List translations of an agreement's file · Get localizations from identityGovernance #
Ask an LLM
“Which languages is a terms of use agreement's default file available in?”
“Can I list the localized versions of an agreement's current file?”
Tell an agent
List the localizations of agreement {agreement}'s default file.
Show which languages the current file of agreement {agreement} is translated into.
POST /identityGovernance/termsOfUse/agreements/{agreement-id}/file/localizations Add a translation to an agreement's file · Create new navigation property to localizations for identityGovernance #
Ask an LLM
“How do I add a new language version of the default terms of use file?”
“Can I attach a localized copy under an agreement's current file?”
Tell an agent
Add a localization to the default file of agreement {agreement}.
Create a localization with versions {versions} under agreement {agreement}'s current file.
GET /identityGovernance/termsOfUse/agreements/{agreement-id}/file/localizations/{agreementFileLocalization-id} Get one translation of an agreement's file · Get localizations from identityGovernance #
Ask an LLM
“How do I fetch one language version of an agreement's default file?”
“What's in a single localization under the agreement's current file?”
Tell an agent
Get localization {agreementFileLocalization} of agreement {agreement}'s default file.
Show translation {agreementFileLocalization} under the current file of agreement {agreement}.
PATCH /identityGovernance/termsOfUse/agreements/{agreement-id}/file/localizations/{agreementFileLocalization-id} Update a translation of an agreement's file · Update the navigation property localizations in identityGovernance #
Ask an LLM
“How do I change one language version under an agreement's default file?”
“Can I replace the version list on a localization of the current terms file?”
Tell an agent
Update localization {agreementFileLocalization} of agreement {agreement}'s default file.
Set versions {versions} on translation {agreementFileLocalization} under agreement {agreement}'s current file.
DELETE /identityGovernance/termsOfUse/agreements/{agreement-id}/file/localizations/{agreementFileLocalization-id} Delete a translation of an agreement's file · Delete navigation property localizations for identityGovernance #
Ask an LLM
“Can I remove one language version from an agreement's default file?”
“How do I delete a localization under the current terms of use file?”
Tell an agent destructive · confirm first
Delete localization {agreementFileLocalization} from agreement {agreement}'s default file.
Remove translation {agreementFileLocalization} under the current file of agreement {agreement}.
GET /identityGovernance/termsOfUse/agreements/{agreement-id}/file/localizations/{agreementFileLocalization-id}/versions List versions of a file translation · Get versions from identityGovernance #
Ask an LLM
“What earlier versions exist for one language of an agreement's default file?”
“Can I see the version history of a localization under the current terms file?”
Tell an agent
List the versions of localization {agreementFileLocalization} in agreement {agreement}'s default file.
Show the version history of translation {agreementFileLocalization} under agreement {agreement}'s current file.
POST /identityGovernance/termsOfUse/agreements/{agreement-id}/file/localizations/{agreementFileLocalization-id}/versions Add a version to a file translation · Create new navigation property to versions for identityGovernance #
Ask an LLM
“How do I add a new version to one language of an agreement's default file?”
“Can I create another version under a localization of the current terms file?”
Tell an agent
Add a version to localization {agreementFileLocalization} of agreement {agreement}'s default file.
Create a new version of translation {agreementFileLocalization} under agreement {agreement}'s current file.
GET /identityGovernance/termsOfUse/agreements/{agreement-id}/file/localizations/{agreementFileLocalization-id}/versions/{agreementFileVersion-id} Get a version of a file translation · Get versions from identityGovernance #
Ask an LLM
“How do I fetch one specific version of a localized default agreement file?”
“What does an individual version under a current-file localization contain?”
Tell an agent
Get version {agreementFileVersion} of localization {agreementFileLocalization} in agreement {agreement}'s default file.
Show current-file version {agreementFileVersion} of translation {agreementFileLocalization} for agreement {agreement}.
PATCH /identityGovernance/termsOfUse/agreements/{agreement-id}/file/localizations/{agreementFileLocalization-id}/versions/{agreementFileVersion-id} Update a version of a file translation · Update the navigation property versions in identityGovernance #
Ask an LLM
“How do I update one version under a localized default agreement file?”
“Can I edit an existing version of a current-file translation?”
Tell an agent
Update version {agreementFileVersion} of localization {agreementFileLocalization} in agreement {agreement}'s default file.
Edit current-file version {agreementFileVersion} of translation {agreementFileLocalization} for agreement {agreement}.
DELETE /identityGovernance/termsOfUse/agreements/{agreement-id}/file/localizations/{agreementFileLocalization-id}/versions/{agreementFileVersion-id} Delete a version of a file translation · Delete navigation property versions for identityGovernance #
Ask an LLM
“Can I remove one old version from a localized default agreement file?”
“Is there a way to prune a stale version from one translation of the default agreement file?”
Tell an agent destructive · confirm first
Delete version {agreementFileVersion} of localization {agreementFileLocalization} in agreement {agreement}'s default file.
Remove current-file version {agreementFileVersion} from translation {agreementFileLocalization} of agreement {agreement}.
GET /identityGovernance/termsOfUse/agreements/{agreement-id}/file/localizations/{agreementFileLocalization-id}/versions/$count Count versions of a file translation · Get the number of the resource #
Ask an LLM
“How many versions does one localization of an agreement's default file have?”
“What's the version count for a translation under the current terms file?”
Tell an agent
Count the versions of localization {agreementFileLocalization} in agreement {agreement}'s default file.
Tell me how many current-file versions translation {agreementFileLocalization} of agreement {agreement} has.
GET /identityGovernance/termsOfUse/agreements/{agreement-id}/file/localizations/$count Count translations of an agreement's file · Get the number of the resource #
Ask an LLM
“How many languages is an agreement's default file localized into?”
“Can I count the localizations under the current terms of use file?”
Tell an agent
Count the localizations of agreement {agreement}'s default file.
Tell me how many translations agreement {agreement}'s current file has.
GET /identityGovernance/termsOfUse/agreements/{agreement-id}/files List an agreement's legacy PDF files · Get files from identityGovernance #
Ask an LLM
“Which PDFs are linked to an agreement through the older, deprecated files collection?”
“Can I still list the legacy files on a terms of use agreement?”
Tell an agent
List the legacy PDF files linked to agreement {agreement}.
Show the deprecated files collection of agreement {agreement}.
POST /identityGovernance/termsOfUse/agreements/{agreement-id}/files Create a localized agreement file · Create agreementFileLocalization #
Ask an LLM
“How do I upload a new localized PDF for a terms of use agreement?”
“Can I add a file in another language to an agreement's files collection?”
Tell an agent
Create a new localized agreement file for agreement {agreement}.
Add a localized PDF with versions {versions} to agreement {agreement}'s files.
GET /identityGovernance/termsOfUse/agreements/{agreement-id}/files/{agreementFileLocalization-id} Get one legacy PDF file of an agreement · Get files from identityGovernance #
Ask an LLM
“Can I open a single PDF from an agreement's deprecated files collection by its ID?”
“What language and display name does one specific legacy agreement PDF carry?”
Tell an agent
Get legacy PDF file {file} from terms of use agreement {agreement}.
Show only {fields} of old-style file {file} on agreement {agreement}.
PATCH /identityGovernance/termsOfUse/agreements/{agreement-id}/files/{agreementFileLocalization-id} Update one legacy PDF file of an agreement · Update the navigation property files in identityGovernance #
Ask an LLM
“Can I still modify a single PDF in an agreement's deprecated files collection?”
“Which properties of one legacy agreement file are editable through the older files endpoint?”
Tell an agent
Update legacy PDF file {file} on terms of use agreement {agreement}.
Patch the versions list of old-style file {file} in agreement {agreement} to {versions}.
DELETE /identityGovernance/termsOfUse/agreements/{agreement-id}/files/{agreementFileLocalization-id} Delete one legacy PDF file from an agreement · Delete navigation property files for identityGovernance #
Ask an LLM
“How can I remove a single outdated PDF from an agreement's deprecated files collection?”
“Is it possible to delete one legacy file only if its ETag still matches?”
Tell an agent destructive · confirm first
Delete legacy PDF file {file} from terms of use agreement {agreement}.
Remove old-style file {file} from agreement {agreement} only if its ETag is {etag}.
GET /identityGovernance/termsOfUse/agreements/{agreement-id}/files/{agreementFileLocalization-id}/versions List versions of a legacy agreement file · Get versions from identityGovernance #
Ask an LLM
“What versions exist for one PDF in an agreement's deprecated files collection?”
“Can I see the version history of a legacy localized agreement file?”
Tell an agent
List the versions of legacy file {agreementFileLocalization} on agreement {agreement}.
Show the version history of PDF {agreementFileLocalization} in agreement {agreement}'s files collection.
POST /identityGovernance/termsOfUse/agreements/{agreement-id}/files/{agreementFileLocalization-id}/versions Add a version to a legacy agreement file · Create new navigation property to versions for identityGovernance #
Ask an LLM
“How do I add a new version to a PDF in an agreement's deprecated files collection?”
“Can I create another version of a legacy localized agreement file?”
Tell an agent
Add a version to legacy file {agreementFileLocalization} on agreement {agreement}.
Create a new version of PDF {agreementFileLocalization} in agreement {agreement}'s files collection.
GET /identityGovernance/termsOfUse/agreements/{agreement-id}/files/{agreementFileLocalization-id}/versions/{agreementFileVersion-id} Get a version of a legacy agreement file · Get versions from identityGovernance #
Ask an LLM
“How do I read one specific version of a PDF in the deprecated files collection?”
“What's stored in a single version of a legacy agreement file?”
Tell an agent
Get version {agreementFileVersion} of legacy file {agreementFileLocalization} on agreement {agreement}.
Show legacy PDF version {agreementFileVersion} of file {agreementFileLocalization} for agreement {agreement}.
PATCH /identityGovernance/termsOfUse/agreements/{agreement-id}/files/{agreementFileLocalization-id}/versions/{agreementFileVersion-id} Update a version of a legacy agreement file · Update the navigation property versions in identityGovernance #
Ask an LLM
“How do I edit one version of a PDF in an agreement's deprecated files collection?”
“Can I update an existing version on a legacy localized agreement file?”
Tell an agent
Update version {agreementFileVersion} of legacy file {agreementFileLocalization} on agreement {agreement}.
Edit legacy PDF version {agreementFileVersion} of file {agreementFileLocalization} for agreement {agreement}.
DELETE /identityGovernance/termsOfUse/agreements/{agreement-id}/files/{agreementFileLocalization-id}/versions/{agreementFileVersion-id} Delete a version of a legacy agreement file · Delete navigation property versions for identityGovernance #
Ask an LLM
“Can I remove one version of a PDF in an agreement's deprecated files collection?”
“How do I delete an outdated version from a legacy agreement file?”
Tell an agent destructive · confirm first
Delete version {agreementFileVersion} of legacy file {agreementFileLocalization} on agreement {agreement}.
Remove legacy PDF version {agreementFileVersion} from file {agreementFileLocalization} of agreement {agreement}.
GET /identityGovernance/termsOfUse/agreements/{agreement-id}/files/{agreementFileLocalization-id}/versions/$count Count versions of a legacy agreement file · Get the number of the resource #
Ask an LLM
“How many versions does one PDF in an agreement's deprecated files collection have?”
“What's the version count for a legacy localized agreement file?”
Tell an agent
Count the versions of legacy file {agreementFileLocalization} on agreement {agreement}.
Tell me how many versions PDF {agreementFileLocalization} in agreement {agreement}'s files collection has.
GET /identityGovernance/termsOfUse/agreements/{agreement-id}/files/$count Count an agreement's legacy PDF files · Get the number of the resource #
Ask an LLM
“How many PDFs are in an agreement's deprecated files collection?”
“Can I count the legacy localized files attached to a terms of use agreement?”
Tell an agent
Count the legacy files on agreement {agreement}.
Tell me how many PDFs agreement {agreement}'s files collection holds.
GET /identityGovernance/termsOfUse/agreements/$count Count terms of use agreements · Get the number of the resource #
Ask an LLM
“How many terms of use agreements does our tenant have?”
“What's the number of agreements whose name matches a search?”
Tell an agent
Count all terms of use agreements.
Count terms of use agreements matching {filter}.

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-identitygovernance-termsofusecontainer-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.

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

OpenAPI Specification

azure-ad-identitygovernance-termsofusecontainer-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Identity.Governance Identity Governance.terms Of Use…
  version: v1.0
servers:
- url: https://graph.microsoft.com/v1.0/
  description: Core
security:
- azureaadv2: []
tags:


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