Microsoft

Microsoft Graph: Multi-tenant management (partners)

Granular delegated admin privileges (GDAP) relationships, access assignments and requests between partners and customers. This listing is one area of…

Developer tools#openapi

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Granular delegated admin privileges (GDAP) relationships, access assignments and requests between partners and customers.

This listing is one area of Microsoft Graph, the single REST API for Microsoft 365, Outlook, OneDrive, Teams and Microsoft Entra ID. It holds 43 of the area's requests, the most direct ones first, generated from Microsoft's own OpenAPI description of Graph v1.0. The other areas (mail, calendar, files, Teams, users and more) are listed separately on the Microsoft page.

Get an access token

  1. Sign in to the Microsoft Entra admin center and open App registrations > New registration. For a quick test, the Graph Explorer signs you in and shows a token without registering anything.
  2. Under API permissions, add the Microsoft Graph permissions this area needs, for example: DelegatedAdminRelationship.ReadWrite.All. Delegated permissions act as the signed-in user; application permissions act as the app itself and need an administrator's consent.
  3. Under Certificates & secrets, create a client secret (keep it out of shared collections).
  4. Get a token from https://login.microsoftonline.com/ /oauth2/v2.0/token: the authorization-code flow for a user, or grant_type=client_credentials with scope=https://graph.microsoft.com/.default for an app. Send it as Authorization: Bearer .

Using these requests

  • Base URL: https://graph.microsoft.com/v1.0. /me/... paths act on the signed-in user; with an application token use /users/{id or userPrincipalName}/... instead.
  • Shape responses with OData query parameters: $select (fields), $filter, $orderby, $top, $expand and $search (some need the ConsistencyLevel: eventual header). Long lists are paged: follow @odata.nextLink.
  • Combine up to 20 requests in one call with POST /$batch.

Common errors

StatusCodeWhat to do
401InvalidAuthenticationTokenThe token is missing, expired or for another resource: get a new one for https://graph.microsoft.com.
403Authorization_RequestDenied / ErrorAccessDeniedAdd the permission listed in the request's docs and grant consent.
404ResourceNotFound / itemNotFoundCheck the id; ids from another user or tenant are not found.
429TooManyRequestsThrottled: wait the Retry-After seconds, then retry.

Docs: Multi-tenant management (partners) overview · Permissions reference · Throttling

Endpoints 43

Tenant relationships

  • GETList tenant relationships/tenantRelationships
  • PATCHUpdate tenant relationships/tenantRelationships
  • GETGet tenant relationship/tenantRelationships/findTenantInformationByTenantId(tenantId=':tenantId')Given a tenant ID, search for a tenant and read its tenantInformation. You can use this API to validate tenant information and use the tenantId to configure…
  • GETGet tenant relationship/tenantRelationships/findTenantInformationByDomainName(domainName=':domainName')Given a domain name, search for a tenant and read its tenantInformation. You can use this API to validate tenant information and use the tenantId to configure…

Tenant relationships: delegated admin customers

  • GETList delegated admin customers/tenantRelationships/delegatedAdminCustomersGet a list of the delegatedAdminCustomer objects and their properties.
  • POSTCreate delegated admin customer/tenantRelationships/delegatedAdminCustomers
  • GETGet delegated admin customer/tenantRelationships/delegatedAdminCustomers/:delegatedAdminCustomer-idRead the properties of a delegatedAdminCustomer object.
  • DELETEDelete delegated admin customer/tenantRelationships/delegatedAdminCustomers/:delegatedAdminCustomer-id
  • PATCHUpdate delegated admin customer/tenantRelationships/delegatedAdminCustomers/:delegatedAdminCustomer-id
  • GETList service management details/tenantRelationships/delegatedAdminCustomers/:delegatedAdminCustomer-id/serviceManagementDetailsGet a list of the delegatedAdminServiceManagementDetail objects and their properties.
  • POSTCreate service management detail/tenantRelationships/delegatedAdminCustomers/:delegatedAdminCustomer-id/serviceManagementDetails
  • GETGet service management detail/tenantRelationships/delegatedAdminCustomers/:delegatedAdminCustomer-id/serviceManagementDetails/:delegatedAdminServiceManagementDetail-idContains the management details of a service in the customer tenant that's managed by delegated administration.
  • DELETEDelete service management detail/tenantRelationships/delegatedAdminCustomers/:delegatedAdminCustomer-id/serviceManagementDetails/:delegatedAdminServiceManagementDetail-id
  • PATCHUpdate service management detail/tenantRelationships/delegatedAdminCustomers/:delegatedAdminCustomer-id/serviceManagementDetails/:delegatedAdminServiceManagementDetail-id

Tenant relationships: multi tenant organization

  • GETGet multi tenant organization/tenantRelationships/multiTenantOrganizationGet properties of the multitenant organization.
  • PATCHUpdate multi tenant organization/tenantRelationships/multiTenantOrganizationUpdate the properties of a multitenant organization.
  • GETList tenants/tenantRelationships/multiTenantOrganization/tenantsList the tenants and their properties in the multitenant organization.
  • POSTCreate tenant/tenantRelationships/multiTenantOrganization/tenantsAdd a tenant to a multitenant organization. The administrator of an owner tenant has the permissions to add tenants to the multitenant organization. The added…
  • GETGet join request/tenantRelationships/multiTenantOrganization/joinRequestGet the status of a tenant joining a multitenant organization.
  • PATCHUpdate join request/tenantRelationships/multiTenantOrganization/joinRequestJoin a multitenant organization, after the owner of the multitenant organization has added your tenant to the multitenant organization as pending. Before a…
  • GETGet tenant/tenantRelationships/multiTenantOrganization/tenants/:multiTenantOrganizationMember-idGet a tenant and its properties in the multitenant organization.
  • DELETEDelete tenant/tenantRelationships/multiTenantOrganization/tenants/:multiTenantOrganizationMember-idRemove a tenant from a multitenant organization. A tenant can be removed in the following scenarios:
  • PATCHUpdate tenant/tenantRelationships/multiTenantOrganization/tenants/:multiTenantOrganizationMember-idUpdate the properties of a tenant in a multitenant organization. Only owner tenants can call this API.

Tenant relationships: delegated admin relationships

  • GETList delegated admin relationships/tenantRelationships/delegatedAdminRelationshipsGet a list of the delegatedAdminRelationship objects and their properties.
  • POSTCreate delegated admin relationship/tenantRelationships/delegatedAdminRelationshipsCreate a new delegatedAdminRelationship object.
  • GETGet delegated admin relationship/tenantRelationships/delegatedAdminRelationships/:delegatedAdminRelationship-idRead the properties of a delegatedAdminRelationship object.
  • DELETEDelete delegated admin relationship/tenantRelationships/delegatedAdminRelationships/:delegatedAdminRelationship-idDelete a delegatedAdminRelationship object. A relationship can only be deleted if it's in the 'created' status.
  • PATCHUpdate delegated admin relationship/tenantRelationships/delegatedAdminRelationships/:delegatedAdminRelationship-idUpdate the properties of a delegatedAdminRelationship object. The following restrictions apply: You can update this relationship when its status property is…
  • GETList requests/tenantRelationships/delegatedAdminRelationships/:delegatedAdminRelationship-id/requestsGet a list of the delegatedAdminRelationshipRequest objects and their properties.
  • POSTCreate request/tenantRelationships/delegatedAdminRelationships/:delegatedAdminRelationship-id/requestsCreate a new delegatedAdminRelationshipRequest object.
  • GETList operations/tenantRelationships/delegatedAdminRelationships/:delegatedAdminRelationship-id/operationsGet a list of the delegatedAdminRelationshipOperation objects and their properties.
  • POSTCreate operation/tenantRelationships/delegatedAdminRelationships/:delegatedAdminRelationship-id/operations
  • GETList access assignments/tenantRelationships/delegatedAdminRelationships/:delegatedAdminRelationship-id/accessAssignmentsGet a list of the delegatedAdminAccessAssignment objects and their properties.
  • POSTCreate access assignment/tenantRelationships/delegatedAdminRelationships/:delegatedAdminRelationship-id/accessAssignmentsCreate a new delegatedAdminAccessAssignment object.
  • GETGet request/tenantRelationships/delegatedAdminRelationships/:delegatedAdminRelationship-id/requests/:delegatedAdminRelationshipRequest-idRead the properties and relationships of a delegatedAdminRelationshipRequest object.
  • DELETEDelete request/tenantRelationships/delegatedAdminRelationships/:delegatedAdminRelationship-id/requests/:delegatedAdminRelationshipRequest-id
  • PATCHUpdate request/tenantRelationships/delegatedAdminRelationships/:delegatedAdminRelationship-id/requests/:delegatedAdminRelationshipRequest-id
  • GETGet operation/tenantRelationships/delegatedAdminRelationships/:delegatedAdminRelationship-id/operations/:delegatedAdminRelationshipOperation-idRead the properties of a delegatedAdminRelationshipOperation object.
  • DELETEDelete operation/tenantRelationships/delegatedAdminRelationships/:delegatedAdminRelationship-id/operations/:delegatedAdminRelationshipOperation-id
  • PATCHUpdate operation/tenantRelationships/delegatedAdminRelationships/:delegatedAdminRelationship-id/operations/:delegatedAdminRelationshipOperation-id
  • GETGet access assignment/tenantRelationships/delegatedAdminRelationships/:delegatedAdminRelationship-id/accessAssignments/:delegatedAdminAccessAssignment-idRead the properties of a delegatedAdminAccessAssignment object.
  • DELETEDelete access assignment/tenantRelationships/delegatedAdminRelationships/:delegatedAdminRelationship-id/accessAssignments/:delegatedAdminAccessAssignment-idDelete a delegatedAdminAccessAssignment object.
  • PATCHUpdate access assignment/tenantRelationships/delegatedAdminRelationships/:delegatedAdminRelationship-id/accessAssignments/:delegatedAdminAccessAssignment-idUpdate the properties of a delegatedAdminAccessAssignment object.

API details

Base URL
https://graph.microsoft.com/v1.0
Authentication
OAuth 2.0 (authorization code, client credentials flows)
Operations
43 operations on 19 pathsGET 19PATCH 10POST 7DELETE 7
Main resources
Tenant relationships: delegated admin relationships 20Tenant relationships: delegated admin customers 10Tenant relationships: multi tenant organization 9Tenant relationships 4
Description format
OpenAPI 3.0.4, API version v1.0

How to test the Microsoft Graph: Multi-tenant management (partners) in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Microsoft Graph: Multi-tenant management (partners) collection, without the publisher's secrets.
  3. Add your credentialsThis API uses OAuth 2.0 (authorization code, client credentials flows). Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “List tenant relationships” (GET /tenantRelationships), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Microsoft Graph: Multi-tenant management (partners)?

Granular delegated admin privileges (GDAP) relationships, access assignments and requests between partners and customers. This listing is one area of… It is listed under Developer tools and has 43 endpoints.

Who publishes the Microsoft Graph: Multi-tenant management (partners)?

It is listed from Microsoft's public API description (an OpenAPI document), not published by Microsoft on Swastik Codes. Anyone who controls microsoft.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Microsoft Graph: Multi-tenant management (partners)?

Requests go to https://graph.microsoft.com/v1.0. Endpoint paths are added to this base URL.

How do I authenticate with the Microsoft Graph: Multi-tenant management (partners)?

With OAuth 2.0 (authorization code, client credentials flows).

How many endpoints does the Microsoft Graph: Multi-tenant management (partners) have?

43 operations on 19 paths (19 GET, 10 PATCH, 7 POST, 7 DELETE). The largest groups are Tenant relationships: delegated admin relationships, Tenant relationships: delegated admin customers, Tenant relationships: multi tenant organization, Tenant relationships.

Is forking the Microsoft Graph: Multi-tenant management (partners) free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.