microsoft.graph.externalConnectors.externalItem

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/microsoft-graph/json-schema/microsoft-graph-microsoft-graph-external-connectors-external-item-schema.json",
  "title": "microsoft.graph.externalConnectors.externalItem",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/microsoft-graph-connections-externalitem-api-openapi.yml#/components/schemas/microsoft.graph.externalConnectors.externalItem",
  "allOf": [
    {
      "$ref": "#/$defs/microsoft.graph.entity"
    },
    {
      "title": "externalItem",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "acl": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/microsoft.graph.externalConnectors.acl"
          },
          "description": "An array of access control entries. Each entry specifies the access granted to a user or group. Required."
        },
        "content": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.externalConnectors.externalItemContent"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "A plain-text  representation of the contents of the item. The text in this property is full-text indexed. Optional."
        },
        "properties": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.externalConnectors.properties"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "A property bag with the properties of the item. The properties MUST conform to the schema defined for the externalConnection. Required."
        },
        "activities": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/microsoft.graph.externalConnectors.externalActivity"
          },
          "description": "Returns a list of activities performed on the item. Write-only.",
          "x-ms-navigationProperty": true
        },
        "@odata.type": {
          "type": "string"
        }
      }
    }
  ],
  "x-ms-discriminator-value": "#microsoft.graph.externalConnectors.externalItem",
  "$defs": {
    "microsoft.graph.entity": {
      "title": "entity",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The unique identifier for an entity. Read-only."
        },
        "@odata.type": {
          "type": "string"
        }
      }
    },
    "microsoft.graph.externalConnectors.accessType": {
      "title": "accessType",
      "enum": [
        "grant",
        "deny",
        "unknownFutureValue"
      ],
      "type": "string"
    },
    "microsoft.graph.externalConnectors.acl": {
      "title": "acl",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "accessType": {
          "$ref": "#/$defs/microsoft.graph.externalConnectors.accessType"
        },
        "type": {
          "$ref": "#/$defs/microsoft.graph.externalConnectors.aclType"
        },
        "value": {
          "type": "string",
          "description": "The unique identifer of the identity. For Microsoft Entra identities, value is set to the object identifier of the user, group or tenant for types user, group and everyone (and everyoneExceptGuests) respectively. For external groups value is set to the ID of the externalGroup"
        },
        "@odata.type": {
          "type": "string"
        }
      }
    },
    "microsoft.graph.externalConnectors.aclType": {
      "title": "aclType",
      "enum": [
        "user",
        "group",
        "everyone",
        "everyoneExceptGuests",
        "externalGroup",
        "unknownFutureValue"
      ],
      "type": "string"
    },
    "microsoft.graph.externalConnectors.externalActivity": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.entity"
        },
        {
          "title": "externalActivity",
          "required": [
            "@odata.type"
          ],
          "type": "object",
          "properties": {
            "startDateTime": {
              "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
              "type": "string",
              "description": "The date and time when the particular activity occurred. The DateTimeOffset 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.",
              "format": "date-time"
            },
            "type": {
              "$ref": "#/$defs/microsoft.graph.externalConnectors.externalActivityType"
            },
            "performedBy": {
              "anyOf": [
                {
                  "$ref": "#/$defs/microsoft.graph.externalConnectors.identity"
                },
                {
                  "type": [
                    "object",
                    "null"
                  ]
                }
              ],
              "description": "Represents an identity used to identify who is responsible for the activity.",
              "x-ms-navigationProperty": true
            },
            "@odata.type": {
              "type": "string"
            }
          }
        }
      ]
    },
    "microsoft.graph.externalConnectors.externalActivityType": {
      "title": "externalActivityType",
      "enum": [
        "viewed",
        "modified",
        "created",
        "commented",
        "unknownFutureValue"
      ],
      "type": "string"
    },
    "microsoft.graph.externalConnectors.externalItemContent": {
      "title": "externalItemContent",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "type": {
          "$ref": "#/$defs/microsoft.graph.externalConnectors.externalItemContentType"
        },
        "value": {
          "type": [
            "string",
            "null"
          ],
          "description": "The content for the externalItem. Required."
        },
        "@odata.type": {
          "type": "string"
        }
      }
    },
    "microsoft.graph.externalConnectors.externalItemContentType": {
      "title": "externalItemContentType",
      "enum": [
        "text",
        "html",
        "unknownFutureValue"
      ],
      "type": "string"
    },
    "microsoft.graph.externalConnectors.identity": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.entity"
        },
        {
          "title": "identity",
          "required": [
            "@odata.type"
          ],
          "type": "object",
          "properties": {
            "type": {
              "anyOf": [
                {
                  "$ref": "#/$defs/microsoft.graph.externalConnectors.identityType"
                },
                {
                  "type": [
                    "object",
                    "null"
                  ]
                }
              ],
              "description": "The type of identity. The possible values are: user or group for Microsoft Entra identities and externalgroup for groups in an external system."
            },
            "@odata.type": {
              "type": "string"
            }
          }
        }
      ],
      "x-ms-discriminator-value": "#microsoft.graph.externalConnectors.identity"
    },
    "microsoft.graph.externalConnectors.identityType": {
      "title": "identityType",
      "enum": [
        "user",
        "group",
        "externalGroup",
        "unknownFutureValue"
      ],
      "type": "string"
    },
    "microsoft.graph.externalConnectors.properties": {
      "title": "properties",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "@odata.type": {
          "type": "string"
        }
      }
    }
  }
}