Show / Hide Table of Contents

ExternalItem.ReadWrite.OwnedBy

Allows the app to read and write external items on behalf of a signed-in user. The signed-in user must be an administrator. The app can only read external items of the connection that it is authorized to.

Graph Methods

Type: A = Application Permission, D = Delegate Permission

Ver Type Method
V1 A,D DELETE /external/connections/{connection-id}/items/{item-id}
V1 A,D DELETE /external/connections/{connectionId}/groups/{externalGroupId}
V1 A,D DELETE /external/connections/{connectionId}/groups/{externalGroupId}/members/{externalGroupMemberId}
V1 A,D DELETE /external/connections/{connectionId}/groups/{externalGroupId}/members/{identityId}
V1 A,D DELETE /external/connections/{connectionsId}/groups/{externalGroupId}
V1 A,D DELETE /external/connections/{connectionsId}/items/{externalItemId}
V1 A,D GET /external/connections/{connection-id}/items/{item-id}
V1 A,D GET /external/connections/{connectionsId}/groups/{externalGroupId}
V1 A,D GET /external/connections/{connectionsId}/items/{externalItemId}
V1 A,D PATCH /external/connections/{connection-id}/items/{item-id}
V1 A,D PATCH /external/connections/{connectionsId}/groups/{externalGroupId}
V1 A POST /connections/{connectionsId}/items/{externalItemId}/addActivities
V1 A,D POST /external/connections/{connectionId}/groups
V1 A,D POST /external/connections/{connectionsId}/groups
V1 A,D POST /external/connections/{connectionsId}/groups/{externalGroupId}/members
V1 A,D PUT /external/connections/{connection-id}/items/{item-id}

Delegate Permission

Id 4367b9d7-cee7-4995-853c-a0bdfe95c1f9
Consent Type Admin
Display String Read and write external items
Description Allows the app to read and write external items on behalf of a signed-in user. The signed-in user must be an administrator. The app can only read external items of the connection that it is authorized to.

Application Permission

Id 8116ae0f-55c2-452d-9944-d18420f5b2c8
Display String Read and write external items
Description Allows the app to read and write external items without a signed-in user. The app can only read external items of the connection that it is authorized to.

Resources

acl

Property Type Description
accessType microsoft.graph.externalConnectors.accessType The access granted to the identity. Possible values are: grant, deny, unknownFutureValue.
type microsoft.graph.externalConnectors.aclType The type of identity. Possible values are: user, group, everyone, everyoneExceptGuests, externalGroup, unknownFutureValue.
value String The unique identifer of the identity. In case of Azure Active Directory identities, value is set to the object identifier of the user, group or tenant for types user, group and everyone (and everyoneExceptGuests) respectively. In case of external groups value is set to the ID of the externalGroup

externalActivity

Property Type Description
startDateTime DateTimeOffset When the particular activity occurred.
type externalConnectors.externalActivityType The type of activity performed. The possible values are: viewed, modified, created, commented, unknownFutureValue.

externalActivityResult

Property Type Description
error microsoft.graph.publicError Error information explaining failure to process external activity.
startDateTime DateTimeOffset When the particular activity occurred. Inherited from externalActivity.
type externalConnectors.externalActivityType The type of activity performed. Inherited from externalActivity. The possible values are: viewed, modified, created, commented, unknownFutureValue.

externalConnection

Property Type Description
configuration microsoft.graph.externalConnectors.configuration Specifies additional application IDs that are allowed to manage the connection and to index content in the connection. Optional.
description String Description of the connection displayed in the Microsoft 365 admin center. Optional.
id String Developer-provided unique ID of the connection within the Azure Active Directory tenant. Must be between 3 and 32 characters in length. Must only contain alphanumeric characters. Cannot begin with Microsoft or be one of the following values: None, Directory, Exchange, ExchangeArchive, LinkedIn, Mailbox, OneDriveBusiness, SharePoint, Teams, Yammer, Connectors, TaskFabric, PowerBI, Assistant, TopicEngine, MSFT_All_Connectors. Required.
name String The display name of the connection to be displayed in the Microsoft 365 admin center. Maximum length of 128 characters. Required.
state microsoft.graph.externalConnectors.connectionState Indicates the current state of the connection. Possible values are: draft, ready, obsolete, limitExceeded, unknownFutureValue.

externalGroup

Property Type Description
description String The description of the external group. Optional.
displayName String The friendly name of the external group. Optional.
id String The unique ID of the external group within a connection. It must be alphanumeric and can be up to 128 characters long.

externalGroupMember

Property Type Description
id String The unique ID of the member. It would be the objectId in case of Azure Active Directory users or groups and the id property of the externalGroup in case of external groups.
type microsoft.graph.externalConnectors.externalGroupMemberType The type of member added to the external group. Possible values are: user or group when the identitySource is azureActiveDirectory and just group when the identitySource is external.
identitySource microsoft.graph.externalConnectors.identitySourceType The identity source that the member belongs to. Possible values are: azureActiveDirectory, external.

externalItem

Property Type Description
acl microsoft.graph.externalConnectors.acl collection An array of access control entries. Each entry specifies the access granted to a user or group. Required.
content microsoft.graph.externalConnectors.externalItemContent A plain-text representation of the contents of the item. The text in this property is full-text indexed. Optional.
id String Developer-provided unique ID of the item within the containing externalConnection. Must be alphanumeric and a maximum of 128 characters. Required.
properties microsoft.graph.externalConnectors.properties A property bag with the properties of the item. The properties MUST conform to the schema defined for the externalConnection. Required.

externalItemContent

Property Type Description
type microsoft.graph.externalConnectors.externalItemContentType The type of content in the value property. Possible values are: text, html, unknownFutureValue. These are the content types that the indexer supports, and not the file extension types allowed.
value String The content for the externalItem. Required.

identity

Property Type Description
id String The unique ID of the identity. It would be the objectId property in case of Azure Active Directory (Azure AD) users or groups and the id property of the externalGroup in the case of external groups.
type microsoft.graph.externalConnectors.identityType The type of identity. Possible values are: user or group for Azure AD identities and externalgroup for groups in an external system.

properties

schema

Property Type Description
baseType String Must be set to microsoft.graph.externalConnector.externalItem. Required.
properties property collection The properties defined for the items in the connection. The minimum number of properties is one, the maximum is 128.
In This Article
Back to top Created by merill | Submit feedback