Microsoft Graph · Schema

microsoft.graph.simulation

Microsoft GraphAzure ADCollaborationContactsDocumentsEmailGraphIdentityMicrosoftOffice 365PresentationsProductivitySpreadsheetsT1Task

Properties

Name Type Description
attackTechnique object The social engineering technique used in the attack simulation and training campaign. Supports $filter and $orderby. The possible values are: unknown, credentialHarvesting, attachmentMalware, driveByU
attackType object Attack type of the attack simulation and training campaign. Supports $filter and $orderby. The possible values are: unknown, social, cloud, endpoint, unknownFutureValue.
automationId string Unique identifier for the attack simulation automation.
completionDateTime string Date and time of completion of the attack simulation and training campaign. Supports $filter and $orderby.
createdBy object Identity of the user who created the attack simulation and training campaign.
createdDateTime string Date and time of creation of the attack simulation and training campaign.
description string Description of the attack simulation and training campaign.
displayName string Display name of the attack simulation and training campaign. Supports $filter and $orderby.
durationInDays number Simulation duration in days.
endUserNotificationSetting object Details about the end user notification setting.
excludedAccountTarget object Users excluded from the simulation.
includedAccountTarget object Users targeted in the simulation.
isAutomated boolean Flag that represents if the attack simulation and training campaign was created from a simulation automation flow. Supports $filter and $orderby.
lastModifiedBy object Identity of the user who most recently modified the attack simulation and training campaign.
lastModifiedDateTime string Date and time of the most recent modification of the attack simulation and training campaign.
launchDateTime string Date and time of the launch/start of the attack simulation and training campaign. Supports $filter and $orderby.
oAuthConsentAppDetail object OAuth app details for the OAuth technique.
payloadDeliveryPlatform object Method of delivery of the phishing payload used in the attack simulation and training campaign. The possible values are: unknown, sms, email, teams, unknownFutureValue.
report object Report of the attack simulation and training campaign.
status object Status of the attack simulation and training campaign. Supports $filter and $orderby. The possible values are: unknown, draft, running, scheduled, succeeded, failed, cancelled, excluded, unknownFuture
trainingSetting object Details about the training settings for a simulation.
landingPage object The landing page associated with a simulation during its creation.
loginPage object The login page associated with a simulation during its creation.
payload object The payload associated with a simulation during its creation.
@odata.type string
View JSON Schema on GitHub

JSON Schema

microsoft-graph-microsoftgraphsimulation-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/microsoft.graph.simulation",
  "title": "microsoft.graph.simulation",
  "allOf": [
    {
      "$ref": "#/components/schemas/microsoft.graph.entity"
    },
    {
      "title": "simulation",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "attackTechnique": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.simulationAttackTechnique"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "The social engineering technique used in the attack simulation and training campaign. Supports $filter and $orderby. The possible values are: unknown, credentialHarvesting, attachmentMalware, driveByUrl, linkInAttachment, linkToMalwareFile, unknownFutureValue, oAuthConsentGrant. Use the Prefer: include-unknown-enum-members request header to get the following values from this evolvable enum: oAuthConsentGrant. For more information on the types of social engineering attack techniques, see simulations."
        },
        "attackType": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.simulationAttackType"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Attack type of the attack simulation and training campaign. Supports $filter and $orderby. The possible values are: unknown, social, cloud, endpoint, unknownFutureValue."
        },
        "automationId": {
          "type": "string",
          "description": "Unique identifier for the attack simulation automation.",
          "nullable": true
        },
        "completionDateTime": {
          "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": "Date and time of completion of the attack simulation and training campaign. Supports $filter and $orderby.",
          "format": "date-time",
          "nullable": true
        },
        "createdBy": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.emailIdentity"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Identity of the user who created the attack simulation and training campaign."
        },
        "createdDateTime": {
          "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": "Date and time of creation of the attack simulation and training campaign.",
          "format": "date-time",
          "nullable": true
        },
        "description": {
          "type": "string",
          "description": "Description of the attack simulation and training campaign.",
          "nullable": true
        },
        "displayName": {
          "type": "string",
          "description": "Display name of the attack simulation and training campaign. Supports $filter and $orderby.",
          "nullable": true
        },
        "durationInDays": {
          "maximum": 2147483647,
          "minimum": -2147483648,
          "type": "number",
          "description": "Simulation duration in days.",
          "format": "int32",
          "nullable": true
        },
        "endUserNotificationSetting": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.endUserNotificationSetting"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Details about the end user notification setting."
        },
        "excludedAccountTarget": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.accountTargetContent"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Users excluded from the simulation."
        },
        "includedAccountTarget": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.accountTargetContent"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Users targeted in the simulation."
        },
        "isAutomated": {
          "type": "boolean",
          "description": "Flag that represents if the attack simulation and training campaign was created from a simulation automation flow. Supports $filter and $orderby.",
          "nullable": true
        },
        "lastModifiedBy": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.emailIdentity"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Identity of the user who most recently modified the attack simulation and training campaign."
        },
        "lastModifiedDateTime": {
          "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": "Date and time of the most recent modification of the attack simulation and training campaign.",
          "format": "date-time",
          "nullable": true
        },
        "launchDateTime": {
          "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": "Date and time of the launch/start of the attack simulation and training campaign. Supports $filter and $orderby.",
          "format": "date-time",
          "nullable": true
        },
        "oAuthConsentAppDetail": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.oAuthConsentAppDetail"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "OAuth app details for the OAuth technique."
        },
        "payloadDeliveryPlatform": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.payloadDeliveryPlatform"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Method of delivery of the phishing payload used in the attack simulation and training campaign. The possible values are: unknown, sms, email, teams, unknownFutureValue."
        },
        "report": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.simulationReport"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Report of the attack simulation and training campaign."
        },
        "status": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.simulationStatus"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Status of the attack simulation and training campaign. Supports $filter and $orderby. The possible values are: unknown, draft, running, scheduled, succeeded, failed, cancelled, excluded, unknownFutureValue."
        },
        "trainingSetting": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.trainingSetting"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Details about the training settings for a simulation."
        },
        "landingPage": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.landingPage"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "The landing page associated with a simulation during its creation.",
          "x-ms-navigationProperty": true
        },
        "loginPage": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.loginPage"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "The login page associated with a simulation during its creation.",
          "x-ms-navigationProperty": true
        },
        "payload": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.payload"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "The payload associated with a simulation during its creation.",
          "x-ms-navigationProperty": true
        },
        "@odata.type": {
          "type": "string"
        }
      }
    }
  ],
  "x-ms-discriminator-value": "#microsoft.graph.simulation"
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/microsoft-graph-microsoftgraphsimulation"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.