TenantGovernance-Invitation.ReadWrite.All

Permission Details

Delegated Permission

Read and write Tenant Governance invitations

Allows the application to list, read, create, and delete Tenant Governance invitations on behalf of the signed-in user.

Permission ID: 42b91635-3803-4af2-a2d5-e91127f9c488

Properties

Microsoft Graph v1.0 endpoint-derived-docs

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property	Type	Description
`id`	`String`	A unique identifier for the object; for example, 12345678-9abc-def0-1234-56789abcde. Key. Not nullable. Read-only. Inherited from entity.
`administrativeUnits`	`administrativeUnit collection`	Conceptual container for user and group directory objects.
`attributeSets`	`attributeSet collection`	Group of related custom security attribute definitions.
`customSecurityAttributeDefinitions`	`customSecurityAttributeDefinition collection`	Schema of a custom security attributes (key-value pairs).
`deletedItems`	`directoryObject collection`	Recently deleted items. Read-only. Nullable.
`deviceLocalCredentials`	`deviceLocalCredentialInfo collection`	The credentials of the device's local administrator account backed up to Microsoft Entra ID.
`federationConfigurations`	`identityProviderBase collection`	Configure domain federation with organizations whose identity provider (IdP) supports either the SAML or WS-Fed protocol.
`onPremisesSynchronization`	`onPremisesDirectorySynchronization collection`	A container for on-premises directory synchronization functionalities that are available for the organization.
`publicKeyInfrastructure`	`object`	The collection of public key infrastructure instances for the certificate-based authentication feature for users in a Microsoft Entra tenant.
`subscriptions`	`companySubscription collection`	List of commercial subscriptions that an organization acquired.

JSON Representation

Microsoft Graph v1.0 endpoint-derived-docs

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation

{
  "@odata.type": "#microsoft.graph.directory"
}

Relationships

Microsoft Graph v1.0 endpoint-derived-docs

Relationships is shown from stable Microsoft Graph v1.0 metadata.

Relationship	Type	Description
`administrativeUnits`	`administrativeUnit collection`	Conceptual container for user and group directory objects.
`attributeSets`	`attributeSet collection`	Group of related custom security attribute definitions.
`customSecurityAttributeDefinitions`	`customSecurityAttributeDefinition collection`	Schema of a custom security attributes (key-value pairs).
`deletedItems`	`directoryObject collection`	Recently deleted items. Read-only. Nullable.
`deviceLocalCredentials`	`deviceLocalCredential collection`	The credentials of the device's local administrator account backed up to Microsoft Entra ID.
`federationConfigurations`	`identityProviderBase collection`	Configure domain federation with organizations whose identity provider (IdP) supports either the SAML or WS-Fed protocol.
`onPremisesSynchronization`	`onPremisesDirectorySynchronization`	A container for on-premises directory synchronization functionalities that are available for the organization.
`publicKeyInfrastructure`	`publicKeyInfrastructureRoot`	The collection of public key infrastructure instances for the certificate-based authentication feature for users in a Microsoft Entra tenant.
`subscriptions`	`companySubscription collection`	List of commercial subscriptions that an organization acquired.
`externalUserProfiles`	`externalUserProfile collection`	Collection of external user profiles that represent collaborators in the directory.
`featureRolloutPolicies`	`featureRolloutPolicy collection`	Related featureRolloutPolicies data exposed by this resource.
`impactedResources`	`impactedResource collection`	Related impactedResources data exposed by this resource.
`inboundSharedUserProfiles`	`inboundSharedUserProfile collection`	A collection of external users whose profile data is shared with the Microsoft Entra tenant. Nullable.
`outboundSharedUserProfiles`	`outboundSharedUserProfile collection`	Related outboundSharedUserProfiles data exposed by this resource.
`pendingExternalUserProfiles`	`pendingExternalUserProfile collection`	Collection of pending external user profiles representing collaborators in the directory that are unredeemed.
`recommendations`	`recommendation collection`	List of recommended improvements to improve tenant posture.
`sharedEmailDomains`	`sharedEmailDomain collection`	Related sharedEmailDomains data exposed by this resource.

Graph Methods

Delegated access App-only access

Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

No API methods available for this version.

Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET `/directory/tenantGovernance/governanceInvitations`
GET `/directory/tenantGovernance/governanceInvitations/{governanceInvitationId}`
POST `/directory/tenantGovernance/governanceInvitations`
DELETE `/directory/tenantGovernance/governanceInvitations/{governanceInvitationId}`

No Microsoft Learn PowerShell mapping available

Microsoft Graph PowerShell v1.0 commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.

No deterministic PowerShell command map is available for this permission.

Browse PowerShell docs

No Microsoft Learn PowerShell mapping available

Microsoft Graph PowerShell beta commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.

No deterministic PowerShell command map is available for this permission.

Browse PowerShell docs

Code Examples

C# / .NET SDK

using Azure.Identity;
using Microsoft.Graph;

var scopes = new[] { "TenantGovernance-Invitation.ReadWrite.All" };
var credential = new InteractiveBrowserCredential(
    new InteractiveBrowserCredentialOptions
    {
        ClientId = "YOUR_CLIENT_ID",
        TenantId = "YOUR_TENANT_ID",
        RedirectUri = new Uri("http://localhost")
    });

var graphClient = new GraphServiceClient(credential, scopes);
var response = await graphClient
    .WithUrl("https://graph.microsoft.com/v1.0/directory/tenantGovernance/governanceInvitations")
    .GetAsync();

JavaScript

Create governanceInvitation

View official example on Microsoft Learn

const options = {
	authProvider,
};

const client = Client.init(options);

const governanceInvitation = {
  governingTenantId: 'aaaabbbb-0000-cccc-1111-dddd2222eeee'
};

await client.api('/directory/tenantGovernance/governanceInvitations')
	.version('beta')
	.post(governanceInvitation);

PowerShell

Connect-MgGraph -Scopes "TenantGovernance-Invitation.ReadWrite.All"
Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/v1.0/directory/tenantGovernance/governanceInvitations"

Python

from azure.identity import InteractiveBrowserCredential
import requests

credential = InteractiveBrowserCredential(
    client_id="YOUR_CLIENT_ID",
    tenant_id="YOUR_TENANT_ID"
)

token = credential.get_token("TenantGovernance-Invitation.ReadWrite.All")
response = requests.get(
    "https://graph.microsoft.com/v1.0/directory/tenantGovernance/governanceInvitations",
    headers={"Authorization": f"Bearer {token.token}"}
)

print(response.json())

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Delegated permissions and search for TenantGovernance-Invitation.ReadWrite.All

4

Grant Admin Consent

This delegated permission requires admin consent.