Microsoft Graph Tenant Relationships

Microsoft Graph Tenant Relationships is the part of the Microsoft Graph API that lets you model and manage how your Microsoft Entra ID tenant relates to other tenants. It provides endpoints to discover external tenants, create and govern delegated admin relationships (GDAP) between partners and customers, manage membership in a multi-tenant organization, and access “managed tenants” data used by Microsoft 365 Lighthouse.

OpenAPI Specification

tenantrelationships-openapi-original.yml Raw ↑
openapi: 3.1.0
info:
  title: Microsoft Graph Tenantrelationships
  description: Needs a description.
paths:
  /tenantRelationships:
    description: Provides operations to manage the tenantRelationship singleton.
    get:
      tags:
        - tenantRelationships.tenantRelationship
      summary: Microsoft Graph Get tenantRelationships
      operationId: tenantRelationships.tenantRelationship.GetTenantRelationship
      parameters:
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          description: Retrieved entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.tenantRelationship'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
        - tenantRelationships.tenantRelationship
      summary: Microsoft Graph Update tenantRelationships
      operationId: tenantRelationships.tenantRelationship.UpdateTenantRelationship
      requestBody:
        description: New property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.tenantRelationship'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.tenantRelationship'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /tenantRelationships/delegatedAdminCustomers:
    description: >-
      Provides operations to manage the delegatedAdminCustomers property of the
      microsoft.graph.tenantRelationship entity.
    get:
      tags:
        - tenantRelationships.delegatedAdminCustomer
      summary: Microsoft Graph List delegatedAdminCustomers
      description: Get a list of the delegatedAdminCustomer objects and their properties.
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/tenantrelationship-list-delegatedadmincustomers?view=graph-rest-1.0
      operationId: tenantRelationships.ListDelegatedAdminCustomers
      parameters:
        - $ref: '#/components/parameters/top'
        - $ref: '#/components/parameters/skip'
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/filter'
        - $ref: '#/components/parameters/count'
        - name: $orderby
          in: query
          description: Order items by property values
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          $ref: >-
            #/components/responses/microsoft.graph.delegatedAdminCustomerCollectionResponse
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
      x-ms-docs-operation-type: operation
    post:
      tags:
        - tenantRelationships.delegatedAdminCustomer
      summary: >-
        Microsoft Graph Create new navigation property to delegatedAdminCustomers for tenantRelationships
      operationId: tenantRelationships.CreateDelegatedAdminCustomers
      requestBody:
        description: New navigation property
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.delegatedAdminCustomer'
        required: true
      responses:
        2XX:
          description: Created navigation property.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.delegatedAdminCustomer'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /tenantRelationships/delegatedAdminCustomers/{delegatedAdminCustomer-id}:
    description: >-
      Provides operations to manage the delegatedAdminCustomers property of the
      microsoft.graph.tenantRelationship entity.
    get:
      tags:
        - tenantRelationships.delegatedAdminCustomer
      summary: Microsoft Graph Get delegatedAdminCustomer
      description: Read the properties of a delegatedAdminCustomer object.
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/delegatedadmincustomer-get?view=graph-rest-1.0
      operationId: tenantRelationships.GetDelegatedAdminCustomers
      parameters:
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          description: Retrieved navigation property
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.delegatedAdminCustomer'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
        - tenantRelationships.delegatedAdminCustomer
      summary: >-
        Microsoft Graph Update the navigation property delegatedAdminCustomers in tenantRelationships
      operationId: tenantRelationships.UpdateDelegatedAdminCustomers
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.delegatedAdminCustomer'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.delegatedAdminCustomer'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
        - tenantRelationships.delegatedAdminCustomer
      summary: >-
        Microsoft Graph Delete navigation property delegatedAdminCustomers for tenantRelationships
      operationId: tenantRelationships.DeleteDelegatedAdminCustomers
      parameters:
        - name: If-Match
          in: header
          description: ETag
          schema:
            type: string
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    parameters:
      - name: delegatedAdminCustomer-id
        in: path
        description: The unique identifier of delegatedAdminCustomer
        required: true
        schema:
          type: string
        x-ms-docs-key-type: delegatedAdminCustomer
  /tenantRelationships/delegatedAdminCustomers/{delegatedAdminCustomer-id}/serviceManagementDetails:
    description: >-
      Provides operations to manage the serviceManagementDetails property of the
      microsoft.graph.delegatedAdminCustomer entity.
    get:
      tags:
        - tenantRelationships.delegatedAdminCustomer
      summary: Microsoft Graph List serviceManagementDetails
      description: >-
        Get a list of the delegatedAdminServiceManagementDetail objects and
        their properties.
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/delegatedadmincustomer-list-servicemanagementdetails?view=graph-rest-1.0
      operationId: tenantRelationships.delegatedAdminCustomers.ListServiceManagementDetails
      parameters:
        - $ref: '#/components/parameters/top'
        - $ref: '#/components/parameters/skip'
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/filter'
        - $ref: '#/components/parameters/count'
        - name: $orderby
          in: query
          description: Order items by property values
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          $ref: >-
            #/components/responses/microsoft.graph.delegatedAdminServiceManagementDetailCollectionResponse
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
      x-ms-docs-operation-type: operation
    post:
      tags:
        - tenantRelationships.delegatedAdminCustomer
      summary: >-
        Microsoft Graph Create new navigation property to serviceManagementDetails for tenantRelationships
      operationId: >-
        tenantRelationships.delegatedAdminCustomers.CreateServiceManagementDetails
      requestBody:
        description: New navigation property
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/microsoft.graph.delegatedAdminServiceManagementDetail
        required: true
      responses:
        2XX:
          description: Created navigation property.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/microsoft.graph.delegatedAdminServiceManagementDetail
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    parameters:
      - name: delegatedAdminCustomer-id
        in: path
        description: The unique identifier of delegatedAdminCustomer
        required: true
        schema:
          type: string
        x-ms-docs-key-type: delegatedAdminCustomer
  ? /tenantRelationships/delegatedAdminCustomers/{delegatedAdminCustomer-id}/serviceManagementDetails/{delegatedAdminServiceManagementDetail-id}
  : description: >-
      Provides operations to manage the serviceManagementDetails property of the
      microsoft.graph.delegatedAdminCustomer entity.
    get:
      tags:
        - tenantRelationships.delegatedAdminCustomer
      summary: Microsoft Graph Get serviceManagementDetails from tenantRelationships
      description: >-
        Contains the management details of a service in the customer tenant
        that's managed by delegated administration.
      operationId: tenantRelationships.delegatedAdminCustomers.GetServiceManagementDetails
      parameters:
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          description: Retrieved navigation property
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/microsoft.graph.delegatedAdminServiceManagementDetail
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
        - tenantRelationships.delegatedAdminCustomer
      summary: >-
        Microsoft Graph Update the navigation property serviceManagementDetails in tenantRelationships
      operationId: >-
        tenantRelationships.delegatedAdminCustomers.UpdateServiceManagementDetails
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/microsoft.graph.delegatedAdminServiceManagementDetail
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/microsoft.graph.delegatedAdminServiceManagementDetail
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
        - tenantRelationships.delegatedAdminCustomer
      summary: >-
        Microsoft Graph Delete navigation property serviceManagementDetails for tenantRelationships
      operationId: >-
        tenantRelationships.delegatedAdminCustomers.DeleteServiceManagementDetails
      parameters:
        - name: If-Match
          in: header
          description: ETag
          schema:
            type: string
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    parameters:
      - name: delegatedAdminCustomer-id
        in: path
        description: The unique identifier of delegatedAdminCustomer
        required: true
        schema:
          type: string
        x-ms-docs-key-type: delegatedAdminCustomer
      - name: delegatedAdminServiceManagementDetail-id
        in: path
        description: The unique identifier of delegatedAdminServiceManagementDetail
        required: true
        schema:
          type: string
        x-ms-docs-key-type: delegatedAdminServiceManagementDetail
  /tenantRelationships/delegatedAdminCustomers/{delegatedAdminCustomer-id}/serviceManagementDetails/$count:
    description: Provides operations to count the resources in the collection.
    get:
      tags:
        - tenantRelationships.delegatedAdminCustomer
      summary: Microsoft Graph Get the number of the resource
      operationId: >-
        tenantRelationships.delegatedAdminCustomers.serviceManagementDetails.GetCount-d662
      parameters:
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/filter'
      responses:
        2XX:
          $ref: '#/components/responses/ODataCountResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
    parameters:
      - name: delegatedAdminCustomer-id
        in: path
        description: The unique identifier of delegatedAdminCustomer
        required: true
        schema:
          type: string
        x-ms-docs-key-type: delegatedAdminCustomer
  /tenantRelationships/delegatedAdminCustomers/$count:
    description: Provides operations to count the resources in the collection.
    get:
      tags:
        - tenantRelationships.delegatedAdminCustomer
      summary: Microsoft Graph Get the number of the resource
      operationId: tenantRelationships.delegatedAdminCustomers.GetCount-e293
      parameters:
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/filter'
      responses:
        2XX:
          $ref: '#/components/responses/ODataCountResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
  /tenantRelationships/delegatedAdminRelationships:
    description: >-
      Provides operations to manage the delegatedAdminRelationships property of
      the microsoft.graph.tenantRelationship entity.
    get:
      tags:
        - tenantRelationships.delegatedAdminRelationship
      summary: Microsoft Graph List delegatedAdminRelationships
      description: >-
        Get a list of the delegatedAdminRelationship objects and their
        properties.
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/tenantrelationship-list-delegatedadminrelationships?view=graph-rest-1.0
      operationId: tenantRelationships.ListDelegatedAdminRelationships
      parameters:
        - $ref: '#/components/parameters/top'
        - $ref: '#/components/parameters/skip'
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/filter'
        - $ref: '#/components/parameters/count'
        - name: $orderby
          in: query
          description: Order items by property values
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          $ref: >-
            #/components/responses/microsoft.graph.delegatedAdminRelationshipCollectionResponse
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
      x-ms-docs-operation-type: operation
    post:
      tags:
        - tenantRelationships.delegatedAdminRelationship
      summary: Microsoft Graph Create delegatedAdminRelationship
      description: Create a new delegatedAdminRelationship object.
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/tenantrelationship-post-delegatedadminrelationships?view=graph-rest-1.0
      operationId: tenantRelationships.CreateDelegatedAdminRelationships
      requestBody:
        description: New navigation property
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.delegatedAdminRelationship'
        required: true
      responses:
        2XX:
          description: Created navigation property.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/microsoft.graph.delegatedAdminRelationship
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /tenantRelationships/delegatedAdminRelationships/{delegatedAdminRelationship-id}:
    description: >-
      Provides operations to manage the delegatedAdminRelationships property of
      the microsoft.graph.tenantRelationship entity.
    get:
      tags:
        - tenantRelationships.delegatedAdminRelationship
      summary: Microsoft Graph Get delegatedAdminRelationship
      description: Read the properties of a delegatedAdminRelationship object.
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/delegatedadminrelationship-get?view=graph-rest-1.0
      operationId: tenantRelationships.GetDelegatedAdminRelationships
      parameters:
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          description: Retrieved navigation property
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/microsoft.graph.delegatedAdminRelationship
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
        - tenantRelationships.delegatedAdminRelationship
      summary: Microsoft Graph Update delegatedAdminRelationship
      description: "Update the properties of a delegatedAdminRelationship object.  The following restrictions apply:\r\n- You can update this relationship when its status property is created.\r\n- You can update the autoExtendDuration property when status is either created or active.\r\n- You can only remove the Microsoft Entra Global Administrator role when the status property is active, which indicates a long-running operation."
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/delegatedadminrelationship-update?view=graph-rest-1.0
      operationId: tenantRelationships.UpdateDelegatedAdminRelationships
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.delegatedAdminRelationship'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/microsoft.graph.delegatedAdminRelationship
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
        - tenantRelationships.delegatedAdminRelationship
      summary: Microsoft Graph Delete delegatedAdminRelationship
      description: >-
        Delete a delegatedAdminRelationship object. A relationship can only be
        deleted if it's in the 'created' status. 
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/delegatedadminrelationship-delete?view=graph-rest-1.0
      operationId: tenantRelationships.DeleteDelegatedAdminRelationships
      parameters:
        - name: If-Match
          in: header
          description: ETag
          schema:
            type: string
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    parameters:
      - name: delegatedAdminRelationship-id
        in: path
        description: The unique identifier of delegatedAdminRelationship
        required: true
        schema:
          type: string
        x-ms-docs-key-type: delegatedAdminRelationship
  /tenantRelationships/delegatedAdminRelationships/{delegatedAdminRelationship-id}/accessAssignments:
    description: >-
      Provides operations to manage the accessAssignments property of the
      microsoft.graph.delegatedAdminRelationship entity.
    get:
      tags:
        - tenantRelationships.delegatedAdminRelationship
      summary: Microsoft Graph List accessAssignments
      description: >-
        Get a list of the delegatedAdminAccessAssignment objects and their
        properties.
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/delegatedadminrelationship-list-accessassignments?view=graph-rest-1.0
      operationId: tenantRelationships.delegatedAdminRelationships.ListAccessAssignments
      parameters:
        - $ref: '#/components/parameters/top'
        - $ref: '#/components/parameters/skip'
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/filter'
        - $ref: '#/components/parameters/count'
        - name: $orderby
          in: query
          description: Order items by property values
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          $ref: >-
            #/components/responses/microsoft.graph.delegatedAdminAccessAssignmentCollectionResponse
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
      x-ms-docs-operation-type: operation
    post:
      tags:
        - tenantRelationships.delegatedAdminRelationship
      summary: Microsoft Graph Create accessAssignments
      description: Create a new delegatedAdminAccessAssignment object.
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/delegatedadminrelationship-post-accessassignments?view=graph-rest-1.0
      operationId: tenantRelationships.delegatedAdminRelationships.CreateAccessAssignments
      requestBody:
        description: New navigation property
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/microsoft.graph.delegatedAdminAccessAssignment
        required: true
      responses:
        2XX:
          description: Created navigation property.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/microsoft.graph.delegatedAdminAccessAssignment
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    parameters:
      - name: delegatedAdminRelationship-id
        in: path
        description: The unique identifier of delegatedAdminRelationship
        required: true
        schema:
          type: string
        x-ms-docs-key-type: delegatedAdminRelationship
  ? /tenantRelationships/delegatedAdminRelationships/{delegatedAdminRelationship-id}/accessAssignments/{delegatedAdminAccessAssignment-id}
  : description: >-
      Provides operations to manage the accessAssignments property of the
      microsoft.graph.delegatedAdminRelationship entity.
    get:
      tags:
        - tenantRelationships.delegatedAdminRelationship
      summary: Microsoft Graph Get delegatedAdminAccessAssignment
      description: Read the properties of a delegatedAdminAccessAssignment object.
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/delegatedadminaccessassignment-get?view=graph-rest-1.0
      operationId: tenantRelationships.delegatedAdminRelationships.GetAccessAssignments
      parameters:
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          description: Retrieved navigation property
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/microsoft.graph.delegatedAdminAccessAssignment
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
        - tenantRelationships.delegatedAdminRelationship
      summary: Microsoft Graph Update delegatedAdminAccessAssignment
      description: Update the properties of a delegatedAdminAccessAssignment object.
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/delegatedadminaccessassignment-update?view=graph-rest-1.0
      operationId: tenantRelationships.delegatedAdminRelationships.UpdateAccessAssignments
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/microsoft.graph.delegatedAdminAccessAssignment
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/microsoft.graph.delegatedAdminAccessAssignment
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
        - tenantRelationships.delegatedAdminRelationship
      summary: Microsoft Graph Delete delegatedAdminAccessAssignment
      description: Delete a delegatedAdminAccessAssignment object.
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/delegatedadminaccessassignment-delete?view=graph-rest-1.0
      operationId: tenantRelationships.delegatedAdminRelationships.DeleteAccessAssignments
      parameters:
        - name: If-Match
          in: header
          description: ETag
          schema:
            type: string
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    parameters:
      - name: delegatedAdminRelationship-id
        in: p

# --- truncated at 32 KB (80 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-graph/refs/heads/main/openapi/tenantrelationships-openapi-original.yml