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"
}