Show / Hide Table of Contents

ExternalConnection.Read.All

Allows the app to read all external connections on behalf of a signed-in user. The signed-in user must be an administrator.

Graph Methods

Type: A = Application Permission, D = Delegate Permission

Ver	Type	Method
V1	A,D	GET /external/connections
V1	A,D	GET /external/connections/{connection-id}/operations/{operation-id}
V1	A,D	GET /external/connections/{connectionsId}
V1	A,D	GET /external/connections/{connectionsId}/operations/{connectionOperationId}
V1	A,D	GET /external/connections/{connectionsId}/schema
V1	A,D	GET /external/connections/{id}
V1	A,D	GET /external/connections/{id}/schema

Delegate Permission


Id	a38267a5-26b6-4d76-9493-935b7599116b
Consent Type	Admin
Display String	Read all external connections
Description	Allows the app to read all external connections on behalf of a signed-in user. The signed-in user must be an administrator.

Application Permission


Id	1914711b-a1cb-4793-b019-c2ce0ed21b8c
Display String	Read all external connections
Description	Allows the app to read all external connections without a signed-in user.

Resources

connectionOperation

Property	Type	Description
error	publicError	If `status` is `failed`, provides more information about the error that caused the failure.
id	String	Unique identifier for the connectionOperation. Read-only.
status	microsoft.graph.externalConnectors.connectionOperationStatus	Indicates the status of the asynchronous operation. Possible values are: `unspecified`, `inprogress`, `completed`, `failed`, `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`.

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.