connectedOrganization resource type

Namespace: microsoft.graph

In Microsoft Entra entitlement management, a connected organization is a reference to a directory or domain of another organization whose users can request access.

Methods

Method Return type Description
List connectedOrganization collection Retrieve a list of connectedOrganization objects.
Create connectedOrganization Create a new connectedOrganization object.
Get connectedOrganization Read properties and relationships of a connectedOrganization object.
Update connectedOrganization collection Update a connectedOrganization.
Delete None Delete a connectedOrganization.
External sponsors
List directoryObject collection Retrieve a list of a connectedOrganization's external sponsors.
Add None Add a user or group to a connectedOrganization's external sponsors.
Remove None Remove a user or group from the connectedOrganization's external sponsors.
Internal sponsors
List directoryObject collection Retrieve a list of a connectedOrganization's internal sponsors.
Add None Add a user or group to a connectedOrganization's internal sponsors.
Remove None Remove a user or group from the connectedOrganization's internal sponsors.

Properties

Property Type Description
createdDateTime DateTimeOffset The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.
description String The description of the connected organization.
displayName String The display name of the connected organization. Supports $filter (eq).
id String Read-only.
identitySources identitySource collection The identity sources in this connected organization, one of azureActiveDirectoryTenant, crossCloudAzureActiveDirectoryTenant, domainIdentitySource, externalDomainFederation, or socialIdentitySource. Nullable.
modifiedDateTime DateTimeOffset *The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.
state connectedOrganizationState The state of a connected organization defines whether assignment policies with requestor scope type AllConfiguredConnectedOrganizationSubjects are applicable or not. The possible values are: configured, proposed, unknownFutureValue.

Relationships

Relationship Type Description
externalSponsors directoryObject collection Nullable.
internalSponsors directoryObject collection Nullable.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.connectedOrganization",
  "description": "String",
  "displayName": "String",
  "createdDateTime": "String (timestamp)",
  "id": "String (identifier)",
  "identitySources": [
    {
      "@odata.type": "microsoft.graph.azureActiveDirectoryTenant"
    }
  ],
  "modifiedDateTime": "String (timestamp)",
  "state": "String"
}