From 10b303389e38f8a9e5fa2c657bbef7720a66d123 Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Tue, 29 Apr 2025 14:13:11 +0300 Subject: [PATCH 01/24] Added implementation for late bound properties --- config/ModuleMetadata.json | 6 +-- config/ModulesMapping.jsonc | 76 +++++++++++++++--------------- src/readme.graph.md | 3 ++ tools/Custom/ModelExtensions.cs | 82 +++++++++++++++++++++++++++++++++ 4 files changed, 126 insertions(+), 41 deletions(-) create mode 100644 tools/Custom/ModelExtensions.cs diff --git a/config/ModuleMetadata.json b/config/ModuleMetadata.json index 25e990b589e..48435d4cf65 100644 --- a/config/ModuleMetadata.json +++ b/config/ModuleMetadata.json @@ -27,15 +27,15 @@ "versions": { "authentication": { "prerelease": "", - "version": "2.27.0" + "version": "2.27.1" }, "beta": { "prerelease": "", - "version": "2.27.0" + "version": "2.27.1" }, "v1.0": { "prerelease": "", - "version": "2.27.0" + "version": "2.27.1" } } } diff --git a/config/ModulesMapping.jsonc b/config/ModulesMapping.jsonc index 42eae1ee71d..ee702b90e4a 100644 --- a/config/ModulesMapping.jsonc +++ b/config/ModulesMapping.jsonc @@ -1,44 +1,44 @@ { "Applications": "^applicationTemplates\\.|^applications\\.|^servicePrincipals\\.|^onPremisesPublishingProfiles\\.|^users.appRoleAssignment$|^groups.appRoleAssignment$", - "Bookings": "^bookingBusinesses\\.|^bookingCurrencies\\.|^solutions.booking.*.Actions$|^solutions.bookingBusiness$|^solutions.bookingCurrency$|^solutions.virtualEventsRoot$|^solutions.booking.*.Functions$|^solutions.solutionsRoot$", - "BusinessScenario": "^solutions.businessScenario$|^solutions.BusinessScenario.*.Actions$|^solutions.BusinessScenario.*.Functions$", - "BackupRestore": "^solutions.backupRestoreRoot$|^solutions.backupRestore.*.Actions$|^solutions.backupRestore.*.Functions$", - "Calendar": "^places\\.|^users.calendar$|^users.calendarGroup$|^users.event$|^groups.calendar$|^groups.event$", - "ChangeNotifications": "^subscriptions\\.", - "CloudCommunications": "^users.onlineMeeting$|^users.presence$|^communications\\.", - "Compliance": "^compliance\\.|^privacy.subjectRightsRequest$", - "CrossDeviceExperiences": "^users.userActivity$|^users.device$", - "Devices.CloudPrint": "^print\\.", - "Devices.CorporateManagement": "^deviceAppManagement\\.|^officeConfiguration\\.|^users.mobileAppIntentAndState$|^users.mobileAppTroubleshootingEvent$|^users.windowsInformationProtectionDeviceRegistration$|^users.managedAppRegistration$|^users.managedDevice$|^users.deviceManagementTroubleshootingEvent$|^users.deviceEnrollmentConfiguration$", - "Devices.ServiceAnnouncement": "^admin.serviceAnnouncement$|^admin.*.Actions$|^admin.*.Functions$", - "DeviceManagement": "^deviceManagement.(deviceCompliancePolicy.*|deviceManagementConfigurationPolicy.*|deviceManagementCompliancePolicy.*|deviceManagementConfigurationSettingDefinition.*|deviceConfiguration.*|managedDevice.*|managementCondition.*|microsoftTunnel.*|windowsInformationProtection.*|deviceManagement|deviceManagement(DerivedCredentialSettings|Intent|ResourceAccessProfileBase|Script|SettingCategory|SettingDefinition|Template|TroubleshootingEvent)|androidForWork(AppConfigurationSchema|Settings)|androidManagedStore(AccountEnterpriseSettings|AppConfigurationSchema)|deviceAndAppManagementAssignmentFilter|deviceCategory|advancedThreatProtectionOnboardingStateSummary|dataSharingConsent|detectedApp|deviceHealthScript|deviceShellScript|embeddedSIMActivationCodePool|groupPolicyConfiguration|macOSSoftwareUpdateAccountSummary|mobileAppTroubleshootingEvent|notificationMessageTemplate|remoteActionAudit|softwareUpdateStatusSummary|windowsMalwareInformation|windowsQualityUpdateProfile)$|^admin.edge$|^deviceManagement.monitoring$|^users.ListCloudPCs$", - "DeviceManagement.Administration": "^deviceManagement.(virtualEndpoint.*|.*Partner.*|.*Certificate.*|.*role.*|deviceManagement(DomainJoinConnector|ExchangeConnector|ExchangeOnPremisesPolicy)|groupPolicy(Category|Definition|DefinitionFile|MigrationReport|ObjectFile|UploadedDefinitionFile)|auditEvent|cartToClassAssociation|comanagementEligibleDevice|deviceAndAppManagementRoleAssignment|intuneBrandingProfile|iosUpdateDeviceStatus|mobileThreatDefenseConnector|ndesConnector|resourceOperation|restrictedAppsViolation|termsAndConditions)", - "DeviceManagement.Enrollment": "^deviceManagement.(.*Enrollment.*|.*Autopilot.*|.*depOnboarding.*|importedDeviceIdentity|onPremisesConditionalAccessSettings|windowsFeatureUpdateProfile)$|^roleManagement.roleManagement$|^roleManagement.rbacApplicationMultiple$|^roleManagement.unifiedRbacApplication$", - "DeviceManagement.Functions": "^deviceManagement.*.Functions$", - "DirectoryObjects": "^directoryObjects\\.|^directory.publicKeyInfrastructureRoot$", - "Education": "^education\\.", - "Files": "^drives\\.|^shares\\.|^users.drive$|^groups.drive$", - "Financials": "^financials\\.", - "Groups": "^groups.group$|^groups.directoryObject$|^groups.conversation$|^groups.endpoint$|^groups.extension$|^groups.groupLifecyclePolicy$|^groups.resourceSpecificPermissionGrant$|^groups.profilePhoto$|^groups.conversationThread$|^groupLifecyclePolicies\\.|^users.group$|^groups.directorySetting$|^groups.*.Actions$|^groups.*.Functions$|^groupSettings\\.|^groups.groupSetting$|^groupSettingTemplates\\.", - "Identity.DirectoryManagement": "^administrativeUnits\\.|^contacts\\.|^devices\\.|^domains\\.|^directoryRoles\\.|^directoryRoleTemplates\\.|^directorySettingTemplates\\.|^settings\\.|^subscribedSkus\\.|^contracts\\.|^directory\\.|^users.scopedRoleMembership$|^organization.organization$|^organization.organizationalBranding$|^organization.organizationSettings$|^organization.*.Actions$|^organization.extension$|^tenantRelationships.*.Actions$|^tenantRelationships.*.Functions$|admin.peopleAdminSettings$|^organization\\.partnerInformation$", - "Identity.Governance": "^accessReviews\\.|^businessFlowTemplates\\.|^programs\\.|^programControls\\.|^programControlTypes\\.|^privilegedRoles\\.|^privilegedRoleAssignments\\.|^privilegedRoleAssignmentRequests\\.|^privilegedApproval\\.|^privilegedOperationEvents\\.|^privilegedAccess\\.|^agreements\\.|^users.agreementAcceptance$|^identityGovernance\\.|^roleManagement.rbacApplication$|^roleManagement.*.Functions$|roleManagement.*.Actions$", +// "Bookings": "^bookingBusinesses\\.|^bookingCurrencies\\.|^solutions.booking.*.Actions$|^solutions.bookingBusiness$|^solutions.bookingCurrency$|^solutions.virtualEventsRoot$|^solutions.booking.*.Functions$|^solutions.solutionsRoot$", +// "BusinessScenario": "^solutions.businessScenario$|^solutions.BusinessScenario.*.Actions$|^solutions.BusinessScenario.*.Functions$", +// "BackupRestore": "^solutions.backupRestoreRoot$|^solutions.backupRestore.*.Actions$|^solutions.backupRestore.*.Functions$", +// "Calendar": "^places\\.|^users.calendar$|^users.calendarGroup$|^users.event$|^groups.calendar$|^groups.event$", +// "ChangeNotifications": "^subscriptions\\.", +// "CloudCommunications": "^users.onlineMeeting$|^users.presence$|^communications\\.", +// "Compliance": "^compliance\\.|^privacy.subjectRightsRequest$", +// "CrossDeviceExperiences": "^users.userActivity$|^users.device$", +// "Devices.CloudPrint": "^print\\.", +// "Devices.CorporateManagement": "^deviceAppManagement\\.|^officeConfiguration\\.|^users.mobileAppIntentAndState$|^users.mobileAppTroubleshootingEvent$|^users.windowsInformationProtectionDeviceRegistration$|^users.managedAppRegistration$|^users.managedDevice$|^users.deviceManagementTroubleshootingEvent$|^users.deviceEnrollmentConfiguration$", +// "Devices.ServiceAnnouncement": "^admin.serviceAnnouncement$|^admin.*.Actions$|^admin.*.Functions$", +// "DeviceManagement": "^deviceManagement.(deviceCompliancePolicy.*|deviceManagementConfigurationPolicy.*|deviceManagementCompliancePolicy.*|deviceManagementConfigurationSettingDefinition.*|deviceConfiguration.*|managedDevice.*|managementCondition.*|microsoftTunnel.*|windowsInformationProtection.*|deviceManagement|deviceManagement(DerivedCredentialSettings|Intent|ResourceAccessProfileBase|Script|SettingCategory|SettingDefinition|Template|TroubleshootingEvent)|androidForWork(AppConfigurationSchema|Settings)|androidManagedStore(AccountEnterpriseSettings|AppConfigurationSchema)|deviceAndAppManagementAssignmentFilter|deviceCategory|advancedThreatProtectionOnboardingStateSummary|dataSharingConsent|detectedApp|deviceHealthScript|deviceShellScript|embeddedSIMActivationCodePool|groupPolicyConfiguration|macOSSoftwareUpdateAccountSummary|mobileAppTroubleshootingEvent|notificationMessageTemplate|remoteActionAudit|softwareUpdateStatusSummary|windowsMalwareInformation|windowsQualityUpdateProfile)$|^admin.edge$|^deviceManagement.monitoring$|^users.ListCloudPCs$", +// "DeviceManagement.Administration": "^deviceManagement.(virtualEndpoint.*|.*Partner.*|.*Certificate.*|.*role.*|deviceManagement(DomainJoinConnector|ExchangeConnector|ExchangeOnPremisesPolicy)|groupPolicy(Category|Definition|DefinitionFile|MigrationReport|ObjectFile|UploadedDefinitionFile)|auditEvent|cartToClassAssociation|comanagementEligibleDevice|deviceAndAppManagementRoleAssignment|intuneBrandingProfile|iosUpdateDeviceStatus|mobileThreatDefenseConnector|ndesConnector|resourceOperation|restrictedAppsViolation|termsAndConditions)", +// "DeviceManagement.Enrollment": "^deviceManagement.(.*Enrollment.*|.*Autopilot.*|.*depOnboarding.*|importedDeviceIdentity|onPremisesConditionalAccessSettings|windowsFeatureUpdateProfile)$|^roleManagement.roleManagement$|^roleManagement.rbacApplicationMultiple$|^roleManagement.unifiedRbacApplication$", +// "DeviceManagement.Functions": "^deviceManagement.*.Functions$", +// "DirectoryObjects": "^directoryObjects\\.|^directory.publicKeyInfrastructureRoot$", +// "Education": "^education\\.", +// "Files": "^drives\\.|^shares\\.|^users.drive$|^groups.drive$", +// "Financials": "^financials\\.", +// "Groups": "^groups.group$|^groups.directoryObject$|^groups.conversation$|^groups.endpoint$|^groups.extension$|^groups.groupLifecyclePolicy$|^groups.resourceSpecificPermissionGrant$|^groups.profilePhoto$|^groups.conversationThread$|^groupLifecyclePolicies\\.|^users.group$|^groups.directorySetting$|^groups.*.Actions$|^groups.*.Functions$|^groupSettings\\.|^groups.groupSetting$|^groupSettingTemplates\\.", +// "Identity.DirectoryManagement": "^administrativeUnits\\.|^contacts\\.|^devices\\.|^domains\\.|^directoryRoles\\.|^directoryRoleTemplates\\.|^directorySettingTemplates\\.|^settings\\.|^subscribedSkus\\.|^contracts\\.|^directory\\.|^users.scopedRoleMembership$|^organization.organization$|^organization.organizationalBranding$|^organization.organizationSettings$|^organization.*.Actions$|^organization.extension$|^tenantRelationships.*.Actions$|^tenantRelationships.*.Functions$|admin.peopleAdminSettings$|^organization\\.partnerInformation$", +// "Identity.Governance": "^accessReviews\\.|^businessFlowTemplates\\.|^programs\\.|^programControls\\.|^programControlTypes\\.|^privilegedRoles\\.|^privilegedRoleAssignments\\.|^privilegedRoleAssignmentRequests\\.|^privilegedApproval\\.|^privilegedOperationEvents\\.|^privilegedAccess\\.|^agreements\\.|^users.agreementAcceptance$|^identityGovernance\\.|^roleManagement.rbacApplication$|^roleManagement.*.Functions$|roleManagement.*.Actions$", "Identity.SignIns": "^organization.certificateBasedAuthConfiguration$|^invitations\\.|^identityProviders\\.|^oauth2PermissionGrants\\.|^identityProtection\\.|^dataPolicyOperations\\.|^identity\\.|^trustFramework\\.|^informationProtection\\.|^policies\\.|^users.authentication$|^users.informationProtection$|^tenantRelationships.multiTenantOrganization$|^policies.deviceRegistrationPolicy$|^policies.deviceRegistrationPolicy$", - "Identity.Partner": "^tenantRelationships.delegatedAdminRelationship$|^tenantRelationships.delegatedAdminCustomer$", - "Mail": "^users.inferenceClassification$|^users.mailFolder$|^users.message$", - "ManagedTenants": "^tenantRelationships.managedTenant$", - "NetworkAccess": "^networkAccess\\.", - "Notes": "^users.onenote$|^groups.onenote$|^sites.onenote$", - "People": "^users.person$|^users.profile$|^users.officeGraphInsights$|^users.userAnalytics$", - "PersonalContacts": "^users.contactFolder$|^users.contact$", - "Planner": "^planner\\.|^users.plannerUser$|^groups.plannerGroup$", - "Reports": "^reports\\.|^auditLogs\\.|^deviceManagement.deviceManagementReports$|^admin.adminReportSetting", - "SchemaExtensions": "^schemaExtensions\\.", - "Search": "^search\\.|^external\\.", - "Security": "^security\\.|^users.security$", - "Sites": "^sites.baseSitePage$|^sites.site$|^sites.itemAnalytics$|^sites.columnDefinition$|^sites.contentType$|^sites.drive$|^sites.list$|^sites.sitePage$|^sites.permission$|^sites.store$|^users.site$|^groups.site$|^sites.*.Functions$|^sites.*.Actions$|^sites.richLongRunningOperation$|^termStore.sets.ListChildren$|^admin.sharepoint$", - "Teams": "^teams\\.|^chats\\.|^users.chat$|^appCatalogs.teamsApp$|^users.userTeamwork$|^teamwork\\.|^users.team$|^groups.team$", +// "Identity.Partner": "^tenantRelationships.delegatedAdminRelationship$|^tenantRelationships.delegatedAdminCustomer$", +// "Mail": "^users.inferenceClassification$|^users.mailFolder$|^users.message$", +// "ManagedTenants": "^tenantRelationships.managedTenant$", +// "NetworkAccess": "^networkAccess\\.", +// "Notes": "^users.onenote$|^groups.onenote$|^sites.onenote$", +// "People": "^users.person$|^users.profile$|^users.officeGraphInsights$|^users.userAnalytics$", +// "PersonalContacts": "^users.contactFolder$|^users.contact$", +// "Planner": "^planner\\.|^users.plannerUser$|^groups.plannerGroup$", +// "Reports": "^reports\\.|^auditLogs\\.|^deviceManagement.deviceManagementReports$|^admin.adminReportSetting", +// "SchemaExtensions": "^schemaExtensions\\.", +// "Search": "^search\\.|^external\\.", +// "Security": "^security\\.|^users.security$", +// "Sites": "^sites.baseSitePage$|^sites.site$|^sites.itemAnalytics$|^sites.columnDefinition$|^sites.contentType$|^sites.drive$|^sites.list$|^sites.sitePage$|^sites.permission$|^sites.store$|^users.site$|^groups.site$|^sites.*.Functions$|^sites.*.Actions$|^sites.richLongRunningOperation$|^termStore.sets.ListChildren$|^admin.sharepoint$", +// "Teams": "^teams\\.|^chats\\.|^users.chat$|^appCatalogs.teamsApp$|^users.userTeamwork$|^teamwork\\.|^users.team$|^groups.team$", "Users": "^users.user$|^users.directoryObject$|^users.licenseDetails$|^users.mailboxSettings|^users.notification$|^users.outlookUser$|^users.profilePhoto$|^users.userSettings$|^users.extension$|^users.oAuth2PermissionGrant$|^users.todo$|^users.itemInsights$|^users.servicePrincipal$", "Users.Actions": "^users.*.Actions$", - "Users.Functions": "^users.*.Functions$", - "WindowsUpdates": "^admin.adminWindows$" +// "Users.Functions": "^users.*.Functions$", +// "WindowsUpdates": "^admin.adminWindows$" } \ No newline at end of file diff --git a/src/readme.graph.md b/src/readme.graph.md index aaa35410a6a..8c0d29e3cc0 100644 --- a/src/readme.graph.md +++ b/src/readme.graph.md @@ -495,6 +495,9 @@ directive: } }); } + + $ = $.replace(/await this\.Client\.(\w+)\(\s*Headers\s*,\s*([^,\s]+)[^;]+;/g,'await Microsoft.Graph.PowerShell.ModelExtensions.ModelExtensions.EnsurePropertiesAreReady($2,failOnExplicitNulls: false);\nawait this.Client.$1(Headers, $2, on2Xx, onDefault, this, Pipeline);') + return $; } diff --git a/tools/Custom/ModelExtensions.cs b/tools/Custom/ModelExtensions.cs new file mode 100644 index 00000000000..9fc42961225 --- /dev/null +++ b/tools/Custom/ModelExtensions.cs @@ -0,0 +1,82 @@ +using System; +using System.Linq; +using System.Reflection; +using System.Threading.Tasks; +using NamespacePrefixPlaceholder.PowerShell.Runtime; + +namespace NamespacePrefixPlaceholder.PowerShell.ModelExtensions +{ + public static class ModelExtensions + { + /// + /// Ensures that all properties marked as set on the model have meaningful values. + /// + /// The model object (must implement IsPropertySet(string)). + /// If true, properties explicitly set to null will be considered invalid (strict mode). + /// Number of retries for late-bound properties. + /// Delay (ms) between retries. + public static async Task EnsurePropertiesAreReady( + this object model, + bool failOnExplicitNulls = false, + int retries = 3, + int delayMs = 100) + { + if (model == null) + throw new ArgumentNullException(nameof(model)); + + // Ensure the model supports IsPropertySet(string) + var isPropertySetMethod = model.GetType().GetMethod("IsPropertySet", BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic); + if (isPropertySetMethod == null) + throw new InvalidOperationException($"{model.GetType().Name} does not implement IsPropertySet(string)"); + + var props = model.GetType().GetProperties(BindingFlags.Instance | BindingFlags.Public); + + for (int attempt = 0; attempt <= retries; attempt++) + { + var unready = props + .Where(p => IsUnready(model, p, isPropertySetMethod, failOnExplicitNulls)) + .ToList(); + + if (!unready.Any()) + return; // Ready! + + if (attempt < retries) + await Task.Delay(delayMs); + } + + // Final check before throwing + var stillUnready = props + .Where(p => IsUnready(model, p, isPropertySetMethod, failOnExplicitNulls)) + .Select(p => p.Name) + .ToList(); + + if (stillUnready.Any()) + { + throw new InvalidOperationException( + $"Model '{model.GetType().Name}' has properties marked as set but not initialized properly: {string.Join(", ", stillUnready)}" + ); + } + } + + private static bool IsUnready(object model, PropertyInfo prop, MethodInfo isPropertySetMethod, bool failOnExplicitNulls) + { + bool isSet = (bool)isPropertySetMethod.Invoke(model, new object[] { prop.Name }); + if (!isSet) return false; // not marked as set, skip + + object value = prop.GetValue(model); + + if (value == null) + return failOnExplicitNulls; // null is OK in relaxed mode, fail in strict + + return IsDefault(value); + } + + private static bool IsDefault(object value) + { + Type type = value.GetType(); + if (!type.IsValueType) return false; + object defaultValue = Activator.CreateInstance(type); + return value.Equals(defaultValue); + } + } +} From 42ab614de316323a46512cd8e39d57c8a24c3fc7 Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Tue, 29 Apr 2025 15:32:11 +0300 Subject: [PATCH 02/24] Updated regex --- src/readme.graph.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/src/readme.graph.md b/src/readme.graph.md index 8c0d29e3cc0..103f1f185d3 100644 --- a/src/readme.graph.md +++ b/src/readme.graph.md @@ -496,7 +496,14 @@ directive: }); } - $ = $.replace(/await this\.Client\.(\w+)\(\s*Headers\s*,\s*([^,\s]+)[^;]+;/g,'await Microsoft.Graph.PowerShell.ModelExtensions.ModelExtensions.EnsurePropertiesAreReady($2,failOnExplicitNulls: false);\nawait this.Client.$1(Headers, $2, on2Xx, onDefault, this, Pipeline);') + let nameSpacePrefixRegex = /(Microsoft(?:\.\w+)*?\.PowerShell)/gm + let nameSpacePrefix = 'Microsoft.Graph.PowerShell'; + if($.match(nameSpacePrefixRegex)){ + let prefixMatch = nameSpacePrefixRegex.exec($); + nameSpacePrefix = prefixMatch[1]; + } + + $ = $.replace(/await this\.Client\.(\w+)\(\s*Headers\s*,\s*([^,\s]+)[^;]+;/g,'await '+nameSpacePrefix+'.ModelExtensions.ModelExtensions.EnsurePropertiesAreReady($2,failOnExplicitNulls: false);\nawait this.Client.$1(Headers, $2, on2Xx, onDefault, this, Pipeline);') return $; From d3aa13104e0a8819dd34425a15cbf7b4c6e9bece Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Tue, 29 Apr 2025 17:29:28 +0300 Subject: [PATCH 03/24] Updated directive --- src/readme.graph.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/readme.graph.md b/src/readme.graph.md index 5ff4e47ee15..9e466dfce7c 100644 --- a/src/readme.graph.md +++ b/src/readme.graph.md @@ -503,7 +503,7 @@ directive: nameSpacePrefix = prefixMatch[1]; } - $ = $.replace(/await this\.Client\.(\w+)\(\s*Headers\s*,\s*([^,\s]+)[^;]+;/g,'await '+nameSpacePrefix+'.ModelExtensions.ModelExtensions.EnsurePropertiesAreReady($2,failOnExplicitNulls: false);\nawait this.Client.$1(Headers, $2, on2Xx, onDefault, this, Pipeline);') + $ = $.replace(/await this\.Client\.(\w+)\(\s*Headers\s*,\s*(BodyParameter|_body)\b([^;]+);/g, 'await '+nameSpacePrefix+'.ModelExtensions.ModelExtensions.EnsurePropertiesAreReady($2,failOnExplicitNulls: false);\nawait this.Client.$1(Headers, $2$3;') return $; From ed503d024ec4812ab031e01cfbae5804dd4fcb9c Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Tue, 29 Apr 2025 20:17:20 +0300 Subject: [PATCH 04/24] Added delay time --- tools/Custom/ModelExtensions.cs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tools/Custom/ModelExtensions.cs b/tools/Custom/ModelExtensions.cs index 9fc42961225..1cf972355fa 100644 --- a/tools/Custom/ModelExtensions.cs +++ b/tools/Custom/ModelExtensions.cs @@ -19,7 +19,7 @@ public static async Task EnsurePropertiesAreReady( this object model, bool failOnExplicitNulls = false, int retries = 3, - int delayMs = 100) + int delayMs = 1000) { if (model == null) throw new ArgumentNullException(nameof(model)); From 7526d4646903adbee7cae142017f9dae09bb2178 Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Tue, 29 Apr 2025 22:52:47 +0300 Subject: [PATCH 05/24] Rolled back everything --- src/readme.graph.md | 45 --------------------------------------------- 1 file changed, 45 deletions(-) diff --git a/src/readme.graph.md b/src/readme.graph.md index 9e466dfce7c..c6286dbf5bf 100644 --- a/src/readme.graph.md +++ b/src/readme.graph.md @@ -336,23 +336,6 @@ directive: //The following regex below adds a property tracker to ensure that users can also pass $Null as an alternative to the current "null" string which gets inferred to null. - const regexP = /AddIf\(\s*null\s*!=\s*\(\(\(object\)this\._(\w+).*?(\(Microsoft.*.PowerShell\.Runtime\.Json\.JsonNode\)).*?"(\w+)".*?container\.Add\s*\);/gm - $ = $.replace(regexP, (match, p1, p2, p3) => { - let capitalizedP1 = p1.charAt(0).toUpperCase() + p1.slice(1); // Capitalize first letter - return `if(this.IsPropertySet("${p1}"))\n\t\t{\n\t\t\tvar propertyInfo = this.GetType().GetProperty("${capitalizedP1}");\n\t\t\tif (propertyInfo != null)\n\t\t\t{\n\t\t\tSystem.Type propertyType = propertyInfo.PropertyType;\n\t\t\t\t\tAddIf(${p2}PropertyTracker.ConvertToJsonNode(propertyType, this._${p1}),"${p1}",container.Add);\n\t\t\t}\n\t\t}`; - }); - - $ = $.replace(/if\s*\(\s*null\s*!=\s*this\._(\w+)\s*\)/gm, 'if(this.IsPropertySet("$1"))') - - let nameSpacePrefixRegex = /(Microsoft(?:\.\w+)*?\.PowerShell)/gm - let nameSpacePrefix = 'Microsoft.Graph.PowerShell'; - if($.match(nameSpacePrefixRegex)){ - let prefixMatch = nameSpacePrefixRegex.exec($); - nameSpacePrefix = prefixMatch[1]; - } - $ = $.replace(/container\.Add\("(\w+)",\s*(__\w+)\);/gm, 'var nullFlag = ('+nameSpacePrefix+'.Runtime.Json.JsonNode)new '+nameSpacePrefix+'.Runtime.Json.JsonString("nullarray");\n\t\tif($2.Count == 0)\n\t\t{\n\t\t\t$2.Add(nullFlag);\n\t\t}\n\t\tcontainer.Add("$1", $2);'); - - $ =$.replace(/AddIf\(\s+null\s+!=\s+(this\._\w+)\s+\?\s+\((Microsoft\.Graph\..*?)\)\s+this\._(\w+)\.ToJson\(null,serializationMode\)\s+:\s+null,\s+"\w+"\s+,container.Add\s+\);/gm, 'if (this.IsPropertySet("$3")) \n{\n if ($1 != null)\n{\n container.Add("$3", ($2)$1.ToJson(null, serializationMode)); \n}\nelse\n{\n container.Add("$3", "null"); \n}\n}'); return $; } @@ -419,28 +402,7 @@ directive: if($.match(additionalPropertiesRegex)) { $ = $.replace(additionalPropertiesRegex, '$1$2 new $3'); } - //The following regex below adds a property tracker to ensure that users can also pass $Null as an alternative to the current "null" string which gets inferred to null. - $ = $.replace(/\bpublic\s+(\w+\??)\s+(\w+)\s*{\s*get\s*=>\s*this\.(\w+);\s*set\s*=>\s*this\.\3\s*=\s*value;\s*}/gmi,'public $1 $2\n\t{\n\t\tget=>this.$3;\n\t\tset\n\t\t{\n\t\t\tthis.$3=SanitizeValue<$1>(value);\n\t\t\tTrackProperty(nameof($2));\n\t\t}\n\t}') - $ = $.replace(/\bpublic\s+(\w+\[\])\s+(\w+)\s*{\s*get\s*=>\s*this\.(\w+);\s*set\s*=>\s*this\.\3\s*=\s*value;\s*}/gm,'public $1 $2\n\t{\n\t\tget=>this.$3;\n\t\tset\n\t\t{\n\t\t\tthis.$3=value;\n\t\t\tTrackProperty(nameof($2));\n\t\t}\n\t}') - - $ = $.replace(/\bpublic\s+(Microsoft\.Graph\.[\w.]+\[\])\s+(\w+)\s*{\s*get\s*=>\s*this\.(\w+);\s*set\s*=>\s*this\.\3\s*=\s*value;\s*}/gm,'public $1 $2\n\t{\n\t\tget=>this.$3;\n\t\tset\n\t\t{\n\t\t\tthis.$3=value;\n\t\t\tTrackProperty(nameof($2));\n\t\t}\n\t}') - - const match = $documentPath.match(/generated%2Fapi%2FModels%2F([\w]*[\w\d]*)\.cs/gm); - if (match) { - let fileName = match[0]; - fileName = fileName.replace('generated%2Fapi%2FModels%2F','') - fileName = fileName.replace('.cs','') - const interfaceName = 'I'+fileName - $ = $.replace('interface '+interfaceName+' :', 'interface '+interfaceName+' : IPropertyTracker,') - const className = fileName - const regexP = new RegExp(`public\\s+partial\\s+class\\s+${className}\\s*:\\s*[\\s\\S]*?{`, "gm"); - var matches = regexP.exec($); - let originalMatch = matches[0]; - $ = $.replace(regexP, originalMatch+'\n\t\tprivate readonly PropertyTracker _propertyTracker = new PropertyTracker();\n\t\tpublic void TrackProperty(string propertyName) => _propertyTracker.TrackProperty(propertyName);\n\t\tpublic bool IsPropertySet(string propertyName) =>_propertyTracker.IsPropertySet(propertyName);\n\t\tpublic T SanitizeValue(object value) => PropertyTracker.SanitizeValue(value);'); - } - - $ = $.replace(/public\s+(Microsoft\.Graph\..*?)\s+(\w+)\s+{\s+get\s+=>\s+\(\s*this\.(\w+)\s+=\s*this\.\3\s+\?\?\s+new\s+(Microsoft\.Graph\..*?)\s+set\s+=>\s+this._\w+\s+=\s+value;\s+}/gm, 'public $1 $2 { \n get => (this.$3 = this.$3 ?? new $4\n set\n {\n this.$3 = value;\n TrackProperty(nameof($2));\n }\n}') return $; @@ -496,14 +458,7 @@ directive: }); } - let nameSpacePrefixRegex = /(Microsoft(?:\.\w+)*?\.PowerShell)/gm - let nameSpacePrefix = 'Microsoft.Graph.PowerShell'; - if($.match(nameSpacePrefixRegex)){ - let prefixMatch = nameSpacePrefixRegex.exec($); - nameSpacePrefix = prefixMatch[1]; - } - $ = $.replace(/await this\.Client\.(\w+)\(\s*Headers\s*,\s*(BodyParameter|_body)\b([^;]+);/g, 'await '+nameSpacePrefix+'.ModelExtensions.ModelExtensions.EnsurePropertiesAreReady($2,failOnExplicitNulls: false);\nawait this.Client.$1(Headers, $2$3;') return $; From 30bef79cc6fe79dc2df5fd28f3da062c88e6d920 Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Wed, 30 Apr 2025 07:32:12 +0300 Subject: [PATCH 06/24] Added another module for tests --- config/ModuleMetadata.json | 6 +++--- config/ModulesMapping.jsonc | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/config/ModuleMetadata.json b/config/ModuleMetadata.json index 48435d4cf65..9661edbe745 100644 --- a/config/ModuleMetadata.json +++ b/config/ModuleMetadata.json @@ -27,15 +27,15 @@ "versions": { "authentication": { "prerelease": "", - "version": "2.27.1" + "version": "2.27.2" }, "beta": { "prerelease": "", - "version": "2.27.1" + "version": "2.27.2" }, "v1.0": { "prerelease": "", - "version": "2.27.1" + "version": "2.27.2" } } } diff --git a/config/ModulesMapping.jsonc b/config/ModulesMapping.jsonc index ee702b90e4a..64340030b67 100644 --- a/config/ModulesMapping.jsonc +++ b/config/ModulesMapping.jsonc @@ -36,7 +36,7 @@ // "Search": "^search\\.|^external\\.", // "Security": "^security\\.|^users.security$", // "Sites": "^sites.baseSitePage$|^sites.site$|^sites.itemAnalytics$|^sites.columnDefinition$|^sites.contentType$|^sites.drive$|^sites.list$|^sites.sitePage$|^sites.permission$|^sites.store$|^users.site$|^groups.site$|^sites.*.Functions$|^sites.*.Actions$|^sites.richLongRunningOperation$|^termStore.sets.ListChildren$|^admin.sharepoint$", -// "Teams": "^teams\\.|^chats\\.|^users.chat$|^appCatalogs.teamsApp$|^users.userTeamwork$|^teamwork\\.|^users.team$|^groups.team$", + "Teams": "^teams\\.|^chats\\.|^users.chat$|^appCatalogs.teamsApp$|^users.userTeamwork$|^teamwork\\.|^users.team$|^groups.team$", "Users": "^users.user$|^users.directoryObject$|^users.licenseDetails$|^users.mailboxSettings|^users.notification$|^users.outlookUser$|^users.profilePhoto$|^users.userSettings$|^users.extension$|^users.oAuth2PermissionGrant$|^users.todo$|^users.itemInsights$|^users.servicePrincipal$", "Users.Actions": "^users.*.Actions$", // "Users.Functions": "^users.*.Functions$", From c87022424e59efea66e7c274cb6aaf9582d25216 Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Wed, 30 Apr 2025 10:50:55 +0300 Subject: [PATCH 07/24] Updated directive --- src/readme.graph.md | 66 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 66 insertions(+) diff --git a/src/readme.graph.md b/src/readme.graph.md index c6286dbf5bf..21337a60606 100644 --- a/src/readme.graph.md +++ b/src/readme.graph.md @@ -336,6 +336,23 @@ directive: //The following regex below adds a property tracker to ensure that users can also pass $Null as an alternative to the current "null" string which gets inferred to null. + const regexP = /AddIf\(\s*null\s*!=\s*\(\(\(object\)this\._(\w+).*?(\(Microsoft.*.PowerShell\.Runtime\.Json\.JsonNode\)).*?"(\w+)".*?container\.Add\s*\);/gm + $ = $.replace(regexP, (match, p1, p2, p3) => { + let capitalizedP1 = p1.charAt(0).toUpperCase() + p1.slice(1); // Capitalize first letter + return `if(this.IsPropertySet("${p1}"))\n\t\t{\n\t\t\tvar propertyInfo = this.GetType().GetProperty("${capitalizedP1}");\n\t\t\tif (propertyInfo != null)\n\t\t\t{\n\t\t\tSystem.Type propertyType = propertyInfo.PropertyType;\n\t\t\t\t\tAddIf(${p2}PropertyTracker.ConvertToJsonNode(propertyType, this._${p1}),"${p1}",container.Add);\n\t\t\t}\n\t\t}`; + }); + + $ = $.replace(/if\s*\(\s*null\s*!=\s*this\._(\w+)\s*\)/gm, 'if(this.IsPropertySet("$1"))') + + let nameSpacePrefixRegex = /(Microsoft(?:\.\w+)*?\.PowerShell)/gm + let nameSpacePrefix = 'Microsoft.Graph.PowerShell'; + if($.match(nameSpacePrefixRegex)){ + let prefixMatch = nameSpacePrefixRegex.exec($); + nameSpacePrefix = prefixMatch[1]; + } + $ = $.replace(/container\.Add\("(\w+)",\s*(__\w+)\);/gm, 'var nullFlag = ('+nameSpacePrefix+'.Runtime.Json.JsonNode)new '+nameSpacePrefix+'.Runtime.Json.JsonString("nullarray");\n\t\tif($2.Count == 0)\n\t\t{\n\t\t\t$2.Add(nullFlag);\n\t\t}\n\t\tcontainer.Add("$1", $2);'); + + $ =$.replace(/AddIf\(\s+null\s+!=\s+(this\._\w+)\s+\?\s+\((Microsoft\.Graph\..*?)\)\s+this\._(\w+)\.ToJson\(null,serializationMode\)\s+:\s+null,\s+"\w+"\s+,container.Add\s+\);/gm, 'if (this.IsPropertySet("$3")) \n{\n if ($1 != null)\n{\n container.Add("$3", ($2)$1.ToJson(null, serializationMode)); \n}\nelse\n{\n container.Add("$3", "null"); \n}\n}'); return $; } @@ -402,7 +419,28 @@ directive: if($.match(additionalPropertiesRegex)) { $ = $.replace(additionalPropertiesRegex, '$1$2 new $3'); } + //The following regex below adds a property tracker to ensure that users can also pass $Null as an alternative to the current "null" string which gets inferred to null. + $ = $.replace(/\bpublic\s+(\w+\??)\s+(\w+)\s*{\s*get\s*=>\s*this\.(\w+);\s*set\s*=>\s*this\.\3\s*=\s*value;\s*}/gmi,'public $1 $2\n\t{\n\t\tget=>this.$3;\n\t\tset\n\t\t{\n\t\t\tthis.$3=SanitizeValue<$1>(value);\n\t\t\tTrackProperty(nameof($2));\n\t\t}\n\t}') + $ = $.replace(/\bpublic\s+(\w+\[\])\s+(\w+)\s*{\s*get\s*=>\s*this\.(\w+);\s*set\s*=>\s*this\.\3\s*=\s*value;\s*}/gm,'public $1 $2\n\t{\n\t\tget=>this.$3;\n\t\tset\n\t\t{\n\t\t\tthis.$3=value;\n\t\t\tTrackProperty(nameof($2));\n\t\t}\n\t}') + + $ = $.replace(/\bpublic\s+(Microsoft\.Graph\.[\w.]+\[\])\s+(\w+)\s*{\s*get\s*=>\s*this\.(\w+);\s*set\s*=>\s*this\.\3\s*=\s*value;\s*}/gm,'public $1 $2\n\t{\n\t\tget=>this.$3;\n\t\tset\n\t\t{\n\t\t\tthis.$3=value;\n\t\t\tTrackProperty(nameof($2));\n\t\t}\n\t}') + + const match = $documentPath.match(/generated%2Fapi%2FModels%2F([\w]*[\w\d]*)\.cs/gm); + if (match) { + let fileName = match[0]; + fileName = fileName.replace('generated%2Fapi%2FModels%2F','') + fileName = fileName.replace('.cs','') + const interfaceName = 'I'+fileName + $ = $.replace('interface '+interfaceName+' :', 'interface '+interfaceName+' : IPropertyTracker,') + const className = fileName + const regexP = new RegExp(`public\\s+partial\\s+class\\s+${className}\\s*:\\s*[\\s\\S]*?{`, "gm"); + var matches = regexP.exec($); + let originalMatch = matches[0]; + $ = $.replace(regexP, originalMatch+'\n\t\tprivate readonly PropertyTracker _propertyTracker = new PropertyTracker();\n\t\tpublic void TrackProperty(string propertyName) => _propertyTracker.TrackProperty(propertyName);\n\t\tpublic bool IsPropertySet(string propertyName) =>_propertyTracker.IsPropertySet(propertyName);\n\t\tpublic T SanitizeValue(object value) => PropertyTracker.SanitizeValue(value);'); + } + + $ = $.replace(/public\s+(Microsoft\.Graph\..*?)\s+(\w+)\s+{\s+get\s+=>\s+\(\s*this\.(\w+)\s+=\s*this\.\3\s+\?\?\s+new\s+(Microsoft\.Graph\..*?)\s+set\s+=>\s+this._\w+\s+=\s+value;\s+}/gm, 'public $1 $2 { \n get => (this.$3 = this.$3 ?? new $4\n set\n {\n this.$3 = value;\n TrackProperty(nameof($2));\n }\n}') return $; @@ -458,7 +496,35 @@ directive: }); } + let nameSpacePrefixRegex = /(Microsoft(?:\.\w+)*?\.PowerShell)/gm + let nameSpacePrefix = 'Microsoft.Graph.PowerShell'; + if($.match(nameSpacePrefixRegex)){ + let prefixMatch = nameSpacePrefixRegex.exec($); + nameSpacePrefix = prefixMatch[1]; + } + + let ensureCall = ''; + if ($.includes('BodyParameter')) { + ensureCall = ` + if (BodyParameter != null) + { + ${nameSpacePrefix}.ModelExtensions.ModelExtensions.EnsurePropertiesAreReady(BodyParameter, failOnExplicitNulls: false).GetAwaiter().GetResult(); + }`; + } else if ($.includes('_body')) { + ensureCall = ` + if (_body != null) + { + ${nameSpacePrefix}.ModelExtensions.ModelExtensions.EnsurePropertiesAreReady(_body, failOnExplicitNulls: false).GetAwaiter().GetResult(); + }`; + } + $ = $.replace( + /protected override void BeginProcessing\(\)\s*\{\s*([\s\S]*?)(if\s*\(Break\))/g, + `protected override void BeginProcessing() { + Module.Instance.SetProxyConfiguration(Proxy, ProxyCredential, ProxyUseDefaultCredentials); + ${ensureCall} + $1$2` + ); return $; From d8c3e3bdc29edbfe440ab99c135b877583c94ec7 Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Wed, 30 Apr 2025 15:15:04 +0300 Subject: [PATCH 08/24] Still troubleshooting --- config/ModuleMetadata.json | 6 +- config/ModulesMapping.jsonc | 14 +- openApiDocs/v1.0/Education.yml | 13987 ------------------------------- src/readme.graph.md | 2 + 4 files changed, 12 insertions(+), 13997 deletions(-) diff --git a/config/ModuleMetadata.json b/config/ModuleMetadata.json index 9661edbe745..083aa159dc7 100644 --- a/config/ModuleMetadata.json +++ b/config/ModuleMetadata.json @@ -27,15 +27,15 @@ "versions": { "authentication": { "prerelease": "", - "version": "2.27.2" + "version": "2.27.3" }, "beta": { "prerelease": "", - "version": "2.27.2" + "version": "2.27.3" }, "v1.0": { "prerelease": "", - "version": "2.27.2" + "version": "2.27.3" } } } diff --git a/config/ModulesMapping.jsonc b/config/ModulesMapping.jsonc index 64340030b67..fdbfe5ecd52 100644 --- a/config/ModulesMapping.jsonc +++ b/config/ModulesMapping.jsonc @@ -1,5 +1,5 @@ { - "Applications": "^applicationTemplates\\.|^applications\\.|^servicePrincipals\\.|^onPremisesPublishingProfiles\\.|^users.appRoleAssignment$|^groups.appRoleAssignment$", +// "Applications": "^applicationTemplates\\.|^applications\\.|^servicePrincipals\\.|^onPremisesPublishingProfiles\\.|^users.appRoleAssignment$|^groups.appRoleAssignment$", // "Bookings": "^bookingBusinesses\\.|^bookingCurrencies\\.|^solutions.booking.*.Actions$|^solutions.bookingBusiness$|^solutions.bookingCurrency$|^solutions.virtualEventsRoot$|^solutions.booking.*.Functions$|^solutions.solutionsRoot$", // "BusinessScenario": "^solutions.businessScenario$|^solutions.BusinessScenario.*.Actions$|^solutions.BusinessScenario.*.Functions$", // "BackupRestore": "^solutions.backupRestoreRoot$|^solutions.backupRestore.*.Actions$|^solutions.backupRestore.*.Functions$", @@ -16,19 +16,19 @@ // "DeviceManagement.Enrollment": "^deviceManagement.(.*Enrollment.*|.*Autopilot.*|.*depOnboarding.*|importedDeviceIdentity|onPremisesConditionalAccessSettings|windowsFeatureUpdateProfile)$|^roleManagement.roleManagement$|^roleManagement.rbacApplicationMultiple$|^roleManagement.unifiedRbacApplication$", // "DeviceManagement.Functions": "^deviceManagement.*.Functions$", // "DirectoryObjects": "^directoryObjects\\.|^directory.publicKeyInfrastructureRoot$", -// "Education": "^education\\.", + "Education": "^education\\.", // "Files": "^drives\\.|^shares\\.|^users.drive$|^groups.drive$", // "Financials": "^financials\\.", // "Groups": "^groups.group$|^groups.directoryObject$|^groups.conversation$|^groups.endpoint$|^groups.extension$|^groups.groupLifecyclePolicy$|^groups.resourceSpecificPermissionGrant$|^groups.profilePhoto$|^groups.conversationThread$|^groupLifecyclePolicies\\.|^users.group$|^groups.directorySetting$|^groups.*.Actions$|^groups.*.Functions$|^groupSettings\\.|^groups.groupSetting$|^groupSettingTemplates\\.", // "Identity.DirectoryManagement": "^administrativeUnits\\.|^contacts\\.|^devices\\.|^domains\\.|^directoryRoles\\.|^directoryRoleTemplates\\.|^directorySettingTemplates\\.|^settings\\.|^subscribedSkus\\.|^contracts\\.|^directory\\.|^users.scopedRoleMembership$|^organization.organization$|^organization.organizationalBranding$|^organization.organizationSettings$|^organization.*.Actions$|^organization.extension$|^tenantRelationships.*.Actions$|^tenantRelationships.*.Functions$|admin.peopleAdminSettings$|^organization\\.partnerInformation$", // "Identity.Governance": "^accessReviews\\.|^businessFlowTemplates\\.|^programs\\.|^programControls\\.|^programControlTypes\\.|^privilegedRoles\\.|^privilegedRoleAssignments\\.|^privilegedRoleAssignmentRequests\\.|^privilegedApproval\\.|^privilegedOperationEvents\\.|^privilegedAccess\\.|^agreements\\.|^users.agreementAcceptance$|^identityGovernance\\.|^roleManagement.rbacApplication$|^roleManagement.*.Functions$|roleManagement.*.Actions$", - "Identity.SignIns": "^organization.certificateBasedAuthConfiguration$|^invitations\\.|^identityProviders\\.|^oauth2PermissionGrants\\.|^identityProtection\\.|^dataPolicyOperations\\.|^identity\\.|^trustFramework\\.|^informationProtection\\.|^policies\\.|^users.authentication$|^users.informationProtection$|^tenantRelationships.multiTenantOrganization$|^policies.deviceRegistrationPolicy$|^policies.deviceRegistrationPolicy$", + // "Identity.SignIns": "^organization.certificateBasedAuthConfiguration$|^invitations\\.|^identityProviders\\.|^oauth2PermissionGrants\\.|^identityProtection\\.|^dataPolicyOperations\\.|^identity\\.|^trustFramework\\.|^informationProtection\\.|^policies\\.|^users.authentication$|^users.informationProtection$|^tenantRelationships.multiTenantOrganization$|^policies.deviceRegistrationPolicy$|^policies.deviceRegistrationPolicy$", // "Identity.Partner": "^tenantRelationships.delegatedAdminRelationship$|^tenantRelationships.delegatedAdminCustomer$", // "Mail": "^users.inferenceClassification$|^users.mailFolder$|^users.message$", // "ManagedTenants": "^tenantRelationships.managedTenant$", // "NetworkAccess": "^networkAccess\\.", // "Notes": "^users.onenote$|^groups.onenote$|^sites.onenote$", -// "People": "^users.person$|^users.profile$|^users.officeGraphInsights$|^users.userAnalytics$", + "People": "^users.person$|^users.profile$|^users.officeGraphInsights$|^users.userAnalytics$", // "PersonalContacts": "^users.contactFolder$|^users.contact$", // "Planner": "^planner\\.|^users.plannerUser$|^groups.plannerGroup$", // "Reports": "^reports\\.|^auditLogs\\.|^deviceManagement.deviceManagementReports$|^admin.adminReportSetting", @@ -36,9 +36,9 @@ // "Search": "^search\\.|^external\\.", // "Security": "^security\\.|^users.security$", // "Sites": "^sites.baseSitePage$|^sites.site$|^sites.itemAnalytics$|^sites.columnDefinition$|^sites.contentType$|^sites.drive$|^sites.list$|^sites.sitePage$|^sites.permission$|^sites.store$|^users.site$|^groups.site$|^sites.*.Functions$|^sites.*.Actions$|^sites.richLongRunningOperation$|^termStore.sets.ListChildren$|^admin.sharepoint$", - "Teams": "^teams\\.|^chats\\.|^users.chat$|^appCatalogs.teamsApp$|^users.userTeamwork$|^teamwork\\.|^users.team$|^groups.team$", - "Users": "^users.user$|^users.directoryObject$|^users.licenseDetails$|^users.mailboxSettings|^users.notification$|^users.outlookUser$|^users.profilePhoto$|^users.userSettings$|^users.extension$|^users.oAuth2PermissionGrant$|^users.todo$|^users.itemInsights$|^users.servicePrincipal$", - "Users.Actions": "^users.*.Actions$", +// "Teams": "^teams\\.|^chats\\.|^users.chat$|^appCatalogs.teamsApp$|^users.userTeamwork$|^teamwork\\.|^users.team$|^groups.team$", +// "Users": "^users.user$|^users.directoryObject$|^users.licenseDetails$|^users.mailboxSettings|^users.notification$|^users.outlookUser$|^users.profilePhoto$|^users.userSettings$|^users.extension$|^users.oAuth2PermissionGrant$|^users.todo$|^users.itemInsights$|^users.servicePrincipal$", +// "Users.Actions": "^users.*.Actions$", // "Users.Functions": "^users.*.Functions$", // "WindowsUpdates": "^admin.adminWindows$" } \ No newline at end of file diff --git a/openApiDocs/v1.0/Education.yml b/openApiDocs/v1.0/Education.yml index 3044f341c14..7f6135758da 100644 --- a/openApiDocs/v1.0/Education.yml +++ b/openApiDocs/v1.0/Education.yml @@ -6,120 +6,7 @@ servers: - url: https://graph.microsoft.com/v1.0/ description: Core paths: - /education: - get: - tags: - - education.educationRoot - summary: Get education - operationId: education.educationRoot_GetEducationRoot - parameters: - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved entity - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRoot' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationRoot - summary: Update education - operationId: education.educationRoot_UpdateEducationRoot - requestBody: - description: New property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRoot' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRoot' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation /education/classes: - get: - tags: - - education.educationClass - summary: List educationClasses - description: Get a list of the educationClass objects and their properties. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-list?view=graph-rest-1.0 - operationId: education_ListClass - parameters: - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationClassCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation post: tags: - education.educationClass @@ -146,13880 +33,6 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}': - get: - tags: - - education.educationClass - summary: Get educationClass - description: 'Retrieve a class from the system. A class is a universal group with a special property that indicates to the system that the group is a class. Group members represent the students; group admins represent the teachers in the class. If you''re using the delegated token, the user will only see classes in which they are members.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-get?view=graph-rest-1.0 - operationId: education_GetClass - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationClass' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationClass - summary: Update educationClass - description: Update the properties of an educationClass object. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-update?view=graph-rest-1.0 - operationId: education_UpdateClass - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationClass' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationClass' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationClass - summary: Delete educationClass - description: 'Delete an educationClass. Because a class is also a universal group, deleting a class deletes the group.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-delete?view=graph-rest-1.0 - operationId: education_DeleteClass - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignmentCategories': - get: - tags: - - education.educationClass - summary: List assignmentCategories - description: Retrieve a list of educationCategory objects. Only teachers can perform this operation. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-list-categories?view=graph-rest-1.0 - operationId: education.class_ListAssignmentCategory - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationCategoryCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationClass - summary: Create educationCategory - description: Create a new educationCategory on an educationClass. Only teachers can perform this operation. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-post-category?view=graph-rest-1.0 - operationId: education.class_CreateAssignmentCategory - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationCategory' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationCategory' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignmentCategories/{educationCategory-id}': - get: - tags: - - education.educationClass - summary: Get educationCategory - description: 'Retrieve an educationCategory object. Only teachers, students, and applications with application permissions can perform this operation.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationcategory-get?view=graph-rest-1.0 - operationId: education.class_GetAssignmentCategory - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationCategory-id - in: path - description: The unique identifier of educationCategory - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationCategory - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationCategory' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationClass - summary: Update the navigation property assignmentCategories in education - operationId: education.class_UpdateAssignmentCategory - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationCategory-id - in: path - description: The unique identifier of educationCategory - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationCategory - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationCategory' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationCategory' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationClass - summary: Delete educationCategory - description: Delete an existing category. Only teachers can perform this operation. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationcategory-delete?view=graph-rest-1.0 - operationId: education.class_DeleteAssignmentCategory - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationCategory-id - in: path - description: The unique identifier of educationCategory - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationCategory - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignmentCategories/$count': - get: - tags: - - education.educationClass - summary: Get the number of the resource - operationId: education.class.assignmentCategory_GetCount - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/classes/{educationClass-id}/assignmentCategories/microsoft.graph.delta()': - get: - tags: - - education.educationClass - summary: Invoke function delta - description: Get a list of newly created or updated educationCategory objects without having to perform a full read of the collection. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationcategory-delta?view=graph-rest-1.0 - operationId: education.class.assignmentCategory_delta - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Success - content: - application/json: - schema: - title: Collection of educationCategory - type: object - properties: - value: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.educationCategory' - '@odata.nextLink': - type: string - nullable: true - '@odata.deltaLink': - type: string - nullable: true - additionalProperties: - type: object - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: function - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - '/education/classes/{educationClass-id}/assignmentDefaults': - get: - tags: - - education.educationClass - summary: Get educationAssignmentDefaults - description: Read the properties and relationships of an educationAssignmentDefaults object. These are the class-level assignment defaults respected by new assignments created in the class. Callers can continue to specify custom values on each assignment creation if they don't want the default behaviors. Only teachers can perform this operation. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignmentdefaults-get?view=graph-rest-1.0 - operationId: education.class_GetAssignmentDefault - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignmentDefaults' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationClass - summary: Update educationAssignmentDefaults - description: Update the properties of an educationAssignmentDefaults object. Only teachers can update these settings. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignmentdefaults-update?view=graph-rest-1.0 - operationId: education.class_UpdateAssignmentDefault - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignmentDefaults' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignmentDefaults' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationClass - summary: Delete navigation property assignmentDefaults for education - operationId: education.class_DeleteAssignmentDefault - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignments': - get: - tags: - - education.educationClass - summary: List class assignments - description: 'Retrieve a list of assignment objects. Only teachers, students, and applications with application permissions can perform this operation. A teacher, or an application running with application permissions, can see all assignment objects for the class. Students can only see assignments that are assigned to them.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-list-assignments?view=graph-rest-1.0 - operationId: education.class_ListAssignment - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationAssignmentCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationClass - summary: Create educationAssignment - description: 'Create a new assignment. Only teachers in a class can create an assignment. Assignments start in draft status, which means that students can''t see the assignment until it''s published.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-post-assignment?view=graph-rest-1.0 - operationId: education.class_CreateAssignment - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}': - get: - tags: - - education.educationClass - summary: Get educationAssignment - description: 'Get the properties and relationships of an assignment. Only teachers, students, and applications with application permissions can perform this operation. Students can only see assignments assigned to them; teachers and applications with application permissions can see all assignments in a class. You can use the Prefer header in your request to get the inactive status in case the assignment is deactivated; otherwise, the response value for the status property is unknownFutureValue.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-get?view=graph-rest-1.0 - operationId: education.class_GetAssignment - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationClass - summary: Update educationassignment - description: 'Update an educationAssignment object. Only teachers can perform this action. Alternatively, request to change the status of an assignment with publish action. Don''t use a PATCH operation for this purpose.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-update?view=graph-rest-1.0 - operationId: education.class_UpdateAssignment - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationClass - summary: Delete educationAssignment - description: Delete an existing assignment. Only teachers within a class can delete assignments. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-delete?view=graph-rest-1.0 - operationId: education.class_DeleteAssignment - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/categories': - get: - tags: - - education.educationClass - summary: List categories - description: 'List all the categories associated with an assignment. Only teachers, students, and applications with application permissions can perform this operation.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-list-categories?view=graph-rest-1.0 - operationId: education.class.assignment_ListCategory - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationCategoryCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationClass - summary: Create educationCategories - description: Add one or more existing educationCategory objects to the specified educationAssignment. Only teachers can perform this operation. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-post-categories?view=graph-rest-1.0 - operationId: education.class.assignment_CreateCategory - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationCategory' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationCategory' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/categories/{educationCategory-id}/$ref': - delete: - tags: - - education.educationClass - summary: Remove educationCategory - description: Remove an educationCategory from an educationAssignment. Only teachers can perform this operation. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-remove-category?view=graph-rest-1.0 - operationId: education.class.assignment.category_DeleteEducationCategoryGraphBPreRef - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationCategory-id - in: path - description: The unique identifier of educationCategory - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationCategory - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/categories/$count': - get: - tags: - - education.educationClass - summary: Get the number of the resource - operationId: education.class.assignment.category_GetCount - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/categories/$ref': - get: - tags: - - education.educationClass - summary: List categories - description: 'List all the categories associated with an assignment. Only teachers, students, and applications with application permissions can perform this operation.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-list-categories?view=graph-rest-1.0 - operationId: education.class.assignment_ListCategoryGraphBPreRef - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/StringCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationClass - summary: Create educationCategories - description: Add one or more existing educationCategory objects to the specified educationAssignment. Only teachers can perform this operation. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-post-categories?view=graph-rest-1.0 - operationId: education.class.assignment_CreateCategoryGraphBPreRef - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - requestBody: - $ref: '#/components/requestBodies/refPostBody' - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationClass - summary: Remove educationCategory - description: Remove an educationCategory from an educationAssignment. Only teachers can perform this operation. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-remove-category?view=graph-rest-1.0 - operationId: education.class.assignment_DeleteCategoryGraphBPreRef - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - - name: '@id' - in: query - description: The delete Uri - required: true - style: form - explode: false - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/categories/microsoft.graph.delta()': - get: - tags: - - education.educationClass - summary: Invoke function delta - description: Get a list of newly created or updated educationCategory objects without having to perform a full read of the collection. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationcategory-delta?view=graph-rest-1.0 - operationId: education.class.assignment.category_delta - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Success - content: - application/json: - schema: - title: Collection of educationCategory - type: object - properties: - value: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.educationCategory' - '@odata.nextLink': - type: string - nullable: true - '@odata.deltaLink': - type: string - nullable: true - additionalProperties: - type: object - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: function - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/gradingCategory': - get: - tags: - - education.educationClass - summary: Get gradingCategory from education - description: 'When set, enables users to weight assignments differently when computing a class average grade.' - operationId: education.class.assignment_GetGradingCategory - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationGradingCategory' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/microsoft.graph.activate': - post: - tags: - - education.educationClass - summary: Invoke action activate - description: Activate an inactive educationAssignment to signal that the assignment has further action items for teachers or students. This action can only be performed by a teacher on currently inactive assignments. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-activate?view=graph-rest-1.0 - operationId: education.class.assignment_activate - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/microsoft.graph.deactivate': - post: - tags: - - education.educationClass - summary: Invoke action deactivate - description: Mark an assigned educationAssignment as inactive to signal that the assignment has no further action items for teachers and students. This action can only be performed by a teacher on assigned assignments. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-deactivate?view=graph-rest-1.0 - operationId: education.class.assignment_deactivate - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/microsoft.graph.publish': - post: - tags: - - education.educationClass - summary: Invoke action publish - description: 'Publish an education assignment. Change the status of an educationAssignment from its original draft status to the published status. You can change the status from draft to scheduled if the assignment is scheduled for a future date. Only a teacher in the class can make this call. When an assignment is in draft status, students will not see the assignment, nor will there be any submission objects. Calling this API creates educationSubmission objects and displays the assignment in each student''s list. The status of the assignment goes back to draft if there is any backend failure during publish process. To update the properties of a published assignment, see update an assignment.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-publish?view=graph-rest-1.0 - operationId: education.class.assignment_publish - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/microsoft.graph.setUpFeedbackResourcesFolder': - post: - tags: - - education.educationClass - summary: Invoke action setUpFeedbackResourcesFolder - description: Create a SharePoint folder to upload feedback files for a given educationSubmission. Only teachers can perform this operation. The teacher determines the resources to upload in the feedback resources folder of a submission. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-setupfeedbackresourcesfolder?view=graph-rest-1.0 - operationId: education.class.assignment_setUpFeedbackResourcesFolder - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/microsoft.graph.setUpResourcesFolder': - post: - tags: - - education.educationClass - summary: Invoke action setUpResourcesFolder - description: 'Create a SharePoint folder to upload files for a given educationAssignment. Only teachers can perform this operation. The teacher determines the resources to upload in the assignment''s folder. ' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-setupresourcesfolder?view=graph-rest-1.0 - operationId: education.class.assignment_setUpResourcesFolder - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/resources': - get: - tags: - - education.educationClass - summary: List assignment resources - description: 'Get all the educationAssignmentResource objects associated with an assignment. Only teachers, students, and applications with application permissions can perform this operation.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-list-resources?view=graph-rest-1.0 - operationId: education.class.assignment_ListResource - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationAssignmentResourceCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationClass - summary: Create educationAssignmentResource - description: 'Create an assignment resource. Only teachers can perform this operation. You can create the following types of assignment resources: Every resource has an @odata.type property to indicate which type of resource is being created.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-post-resource?view=graph-rest-1.0 - operationId: education.class.assignment_CreateResource - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/resources/{educationAssignmentResource-id}': - get: - tags: - - education.educationClass - summary: Get educationAssignmentResource - description: 'Get the properties of an education assignment resource associated with an assignment. Only teachers, students, and applications with application permissions can perform this operation.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignmentresource-get?view=graph-rest-1.0 - operationId: education.class.assignment_GetResource - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationAssignmentResource-id - in: path - description: The unique identifier of educationAssignmentResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignmentResource - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationClass - summary: Update the navigation property resources in education - operationId: education.class.assignment_UpdateResource - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationAssignmentResource-id - in: path - description: The unique identifier of educationAssignmentResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignmentResource - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationClass - summary: Delete educationAssignmentResource - description: 'Delete a specific educationAssignmentResource attached to an assignment. In general, only teachers in the class can remove a resource. However, teachers can''t remove resources marked as ''distributeToStudents'', after the assignment has been published to students.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignmentresource-delete?view=graph-rest-1.0 - operationId: education.class.assignment_DeleteResource - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationAssignmentResource-id - in: path - description: The unique identifier of educationAssignmentResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignmentResource - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/resources/$count': - get: - tags: - - education.educationClass - summary: Get the number of the resource - operationId: education.class.assignment.resource_GetCount - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/rubric': - get: - tags: - - education.educationClass - summary: Get educationRubric attached to educationAssignment - description: 'Get the educationRubric object attached to an educationAssignment, if one exists. Only teachers, students, and applications with application permissions can perform this operation.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-get-rubric?view=graph-rest-1.0 - operationId: education.class.assignment_GetRubric - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRubric' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationClass - summary: Attach educationRubric to an assignment - description: Attach an existing educationRubric object to an educationAssignment. Only teachers can perform this operation. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-put-rubric?view=graph-rest-1.0 - operationId: education.class.assignment_UpdateRubric - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRubric' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRubric' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationClass - summary: Delete educationRubric from educationAssignment - description: Remove an educationRubric from an educationAssignment. This method doesn't delete the rubric itself and can only be performed by teachers. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-delete-rubric?view=graph-rest-1.0 - operationId: education.class.assignment_DeleteRubric - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/rubric/$ref': - get: - tags: - - education.educationClass - summary: Get educationRubric attached to educationAssignment - description: 'Get the educationRubric object attached to an educationAssignment, if one exists. Only teachers, students, and applications with application permissions can perform this operation.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-get-rubric?view=graph-rest-1.0 - operationId: education.class.assignment_GetRubricGraphBPreRef - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - responses: - 2XX: - description: Retrieved navigation property link - content: - application/json: - schema: - type: string - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - put: - tags: - - education.educationClass - summary: Attach educationRubric to an assignment - description: Attach an existing educationRubric object to an educationAssignment. Only teachers can perform this operation. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-put-rubric?view=graph-rest-1.0 - operationId: education.class.assignment_SetRubricGraphBPreRef - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - requestBody: - $ref: '#/components/requestBodies/refPutBody' - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationClass - summary: Delete educationRubric from educationAssignment - description: Remove an educationRubric from an educationAssignment. This method doesn't delete the rubric itself and can only be performed by teachers. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-delete-rubric?view=graph-rest-1.0 - operationId: education.class.assignment_DeleteRubricGraphBPreRef - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions': - get: - tags: - - education.educationClass - summary: List submissions - description: 'List all the submissions associated with an assignment. Only teachers, students, and applications with application permissions can perform this operation. A teacher or an application with application permissions can get all the submissions while a student can only get submissions that they''re associated with.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-list-submissions?view=graph-rest-1.0 - operationId: education.class.assignment_ListSubmission - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationSubmissionCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationClass - summary: Create new navigation property to submissions for education - operationId: education.class.assignment_CreateSubmission - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}': - get: - tags: - - education.educationClass - summary: Get educationSubmission - description: 'Retrieve a particular submission. Only teachers, students, and applications with application permissions can perform this operation. A submission object represents a student''s work for an assignment. Resources associated with the submission represent this work. Only the assignedTo student can see and modify the submission. A teacher or application with application permissions has full access to all submissions. The grade and feedback from a teacher are part of the educationOutcome associated with this object. Only teachers or applications with application permissions can add or change grades and feedback. Students will not see the grade or feedback until the assignment has been released.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-get?view=graph-rest-1.0 - operationId: education.class.assignment_GetSubmission - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationClass - summary: Update the navigation property submissions in education - operationId: education.class.assignment_UpdateSubmission - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationClass - summary: Delete navigation property submissions for education - operationId: education.class.assignment_DeleteSubmission - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.excuse': - post: - tags: - - education.educationClass - summary: Invoke action excuse - description: 'Excuse a submission. Excused submissions aren''t included in average grade calculations. Grading rubrics and feedback are deleted. Only teachers can perform this action. If the Prefer: include-unknown-enum-members request header is provided, the excused submission shows the excused status. Otherwise, the submission status retains the returned status. For more information about how to use this header, see the Examples section.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-excuse?view=graph-rest-1.0 - operationId: education.class.assignment.submission_excuse - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.reassign': - post: - tags: - - education.educationClass - summary: Invoke action reassign - description: 'Reassign the submission to the student with feedback for review. Only teachers can perform this action. Include the Prefer: include-unknown-enum-members header when you call this method; otherwise, a reassigned submission is treated as a returned submission. This means that the reassigned status is mapped to the returned status, and reassignedDateTime and reassignedBy properties are mapped to returnedDateTime and returnedBy respectively. If the header Prefer: include-unknown-enum-members is provided, a reassigned submission retains the reassigned status. For details, see the examples section.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-reassign?view=graph-rest-1.0 - operationId: education.class.assignment.submission_reassign - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.return': - post: - tags: - - education.educationClass - summary: Invoke action return - description: Make the grade and feedback associated with this submission available to the student. This action changes the status of the submission from 'submitted' to 'returned' and indicates that feedback is provided or grading is done. This action can only be done by the teacher. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-return?view=graph-rest-1.0 - operationId: education.class.assignment.submission_return - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.setUpResourcesFolder': - post: - tags: - - education.educationClass - summary: Invoke action setUpResourcesFolder - description: 'Trigger the creation of the SharePoint resource folder where all file-based resources (Word, Excel, and so on) should be uploaded for a given submission. Only teachers and students can perform this operation. Note that files must be located in this folder in order to be added as resources. Only a student in the class can determine what files to upload in a given submission-level resource folder. ' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-setupresourcesfolder?view=graph-rest-1.0 - operationId: education.class.assignment.submission_setUpResourcesFolder - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.submit': - post: - tags: - - education.educationClass - summary: Invoke action submit - description: 'Indicate that a student is done with the work and is ready to hand in the assignment. Only teachers, students, and applications with application permissions can perform this operation. This method changes the status of the submission from working to submitted. During the submit process, all the resources are copied to the submittedResources bucket. The teacher will be looking at the submitted resources list for grading. A teacher can also submit a student''s assignment on their behalf.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-submit?view=graph-rest-1.0 - operationId: education.class.assignment.submission_submit - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.unsubmit': - post: - tags: - - education.educationClass - summary: Invoke action unsubmit - description: 'Indicate that a student wants to work on the submission of the assignment after it was turned in. Only teachers, students, and applications with application permissions can perform this operation. This method changes the status of the submission from submitted to working. During the submit process, all the resources are copied from submittedResources to workingResources. The teacher will be looking at the working resources list for grading. A teacher can also unsubmit a student''s assignment on their behalf.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-unsubmit?view=graph-rest-1.0 - operationId: education.class.assignment.submission_unsubmit - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/outcomes': - get: - tags: - - education.educationClass - summary: List outcomes - description: 'Retrieve a list of educationOutcome objects. There are four types of outcomes: educationPointsOutcome, educationFeedbackOutcome, educationRubricOutcome, and educationFeedbackResourceOutcome. Only teachers, students, and applications with application permissions can perform this operation. A submission for a credit assignment (one that has no point value and no rubric) has an educationFeedbackOutcome. (It might also return an educationPointsOutcome, but that outcome is ignored.) A submission for a points assignment (one that has a point value assigned) has both an educationFeedbackOutcome and an educationPointsOutcome. A submission for an assignment with an attached rubric, if the rubric is a credit rubric (no points), has an educationFeedbackOutcome and an educationRubricOutcome. (It might also return an educationPointsOutcome, but that outcome is ignored.) A submission for an assignment with an attached rubric, if the rubric is a points rubric, has an educationFeedbackOutcome, an educationPointsOutcome, and an educationRubricOutcome. A submission for a feedback resource has an educationFeedbackResourceOutcome. All outcome types have a regular and a published property appropriate to that type of outcome; for example, points and publishedPoints, feedback and publishedFeedback. The regular property is the most recent value updated by the teacher; the published property is the most recent value returned to the student.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-list-outcomes?view=graph-rest-1.0 - operationId: education.class.assignment.submission_ListOutcome - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationOutcomeCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationClass - summary: Create educationFeedbackResourceOutcome - description: 'Create a new feedback resource for a submission. Only a teacher can perform this operation. To create a new file-based resource, upload the file to the feedback resources folder associated with the assignment. If the file doesn''t exist or isn''t in that folder, the POST request will fail.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationfeedbackresourceoutcome-post-outcomes?view=graph-rest-1.0 - operationId: education.class.assignment.submission_CreateOutcome - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationOutcome' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationOutcome' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/outcomes/{educationOutcome-id}': - get: - tags: - - education.educationClass - summary: Get outcomes from education - operationId: education.class.assignment.submission_GetOutcome - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationOutcome-id - in: path - description: The unique identifier of educationOutcome - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationOutcome - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationOutcome' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationClass - summary: Update educationOutcome - description: Update the properties of an educationOutcome object. Only teachers can perform this operation. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationoutcome-update?view=graph-rest-1.0 - operationId: education.class.assignment.submission_UpdateOutcome - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationOutcome-id - in: path - description: The unique identifier of educationOutcome - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationOutcome - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationOutcome' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationOutcome' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationClass - summary: Delete educationFeedbackResourceOutcome - description: Delete a feedback resource from a submission. This can only be done by a teacher. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationfeedbackresourceoutcome-delete?view=graph-rest-1.0 - operationId: education.class.assignment.submission_DeleteOutcome - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationOutcome-id - in: path - description: The unique identifier of educationOutcome - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationOutcome - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/outcomes/$count': - get: - tags: - - education.educationClass - summary: Get the number of the resource - operationId: education.class.assignment.submission.outcome_GetCount - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/resources': - get: - tags: - - education.educationClass - summary: List submission resources - description: 'List the resources associated with a submission. Only teachers, students, and applications with application permissions can perform this operation. The educationSubmissionResource object is a wrapper around the actual resource object the student is working on. The wrapper also includes a pointer to the resources on the assignment if this resource was copied from the assignment during the assign process. These resources are the working copy of the assignment. The submittedResources are the resources that were officially submitted for grading.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-list-resources?view=graph-rest-1.0 - operationId: education.class.assignment.submission_ListResource - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationSubmissionResourceCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationClass - summary: Create educationSubmissionResource - description: 'Add an educationSubmissionResource to a submission resource list. Only teachers and students can perform this operation. The operation will not succeed if the allowStudentsToAddResources flag is not set to true. To create a new file-based resource, upload the file to the resources folder associated with the submission. If the file doesn''t exist or is not in that folder, the POST request will fail.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-post-resources?view=graph-rest-1.0 - operationId: education.class.assignment.submission_CreateResource - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/resources/{educationSubmissionResource-id}': - get: - tags: - - education.educationClass - summary: Get educationSubmissionResource - description: 'Retrieve the properties of a specific resource associated with a submission. Only teachers, students, and applications with application permissions can perform this operation. This resource is in the ''working'' resource list and should be considered work in process by a student. This resource is wrapped with a possible pointer back to the assignment resource if it was copied from the assignment.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmissionresource-get?view=graph-rest-1.0 - operationId: education.class.assignment.submission_GetResource - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationSubmissionResource-id - in: path - description: The unique identifier of educationSubmissionResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmissionResource - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationClass - summary: Update the navigation property resources in education - operationId: education.class.assignment.submission_UpdateResource - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationSubmissionResource-id - in: path - description: The unique identifier of educationSubmissionResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmissionResource - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationClass - summary: Delete educationSubmissionResource - description: 'Delete an educationSubmissionResource from the submission. Only teachers and students can perform this operation. If the resource was copied from the assignment, a new copy of the resource will be created after the current copy is deleted. This allows you to ''reset'' the resource to its original state. If the resource wasn''t copied from the assignment but was added from the student, the resource is deleted.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmissionresource-delete?view=graph-rest-1.0 - operationId: education.class.assignment.submission_DeleteResource - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationSubmissionResource-id - in: path - description: The unique identifier of educationSubmissionResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmissionResource - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/resources/$count': - get: - tags: - - education.educationClass - summary: Get the number of the resource - operationId: education.class.assignment.submission.resource_GetCount - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/submittedResources': - get: - tags: - - education.educationClass - summary: List submittedResources - description: 'List the educationSubmissionResource objects that were officially submitted for grading. Only teachers, students, and applications with application permissions can perform this operation. The student who owns the submission can''t change the submitted list without resubmitting the assignment. This resource is a wrapper around the real resource and can contain a pointer back to the actual assignment resource if this resource was copied from the assignment.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-list-submittedresources?view=graph-rest-1.0 - operationId: education.class.assignment.submission_ListSubmittedResource - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationSubmissionResourceCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationClass - summary: Create new navigation property to submittedResources for education - operationId: education.class.assignment.submission_CreateSubmittedResource - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/submittedResources/{educationSubmissionResource-id}': - get: - tags: - - education.educationClass - summary: Get educationSubmittedSubmissionResource - description: 'Retrieve a submitted resource. Only teachers, students, and applications with application permissions can perform this operation. Resources are available to a teacher or an application with application permissions after a student submits it, and are available to the student after the teacher returns the submission. Teachers can leave notes in some resources.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmittedsubmissionresource-get?view=graph-rest-1.0 - operationId: education.class.assignment.submission_GetSubmittedResource - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationSubmissionResource-id - in: path - description: The unique identifier of educationSubmissionResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmissionResource - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationClass - summary: Update the navigation property submittedResources in education - operationId: education.class.assignment.submission_UpdateSubmittedResource - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationSubmissionResource-id - in: path - description: The unique identifier of educationSubmissionResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmissionResource - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationClass - summary: Delete navigation property submittedResources for education - operationId: education.class.assignment.submission_DeleteSubmittedResource - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationSubmissionResource-id - in: path - description: The unique identifier of educationSubmissionResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmissionResource - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/submittedResources/$count': - get: - tags: - - education.educationClass - summary: Get the number of the resource - operationId: education.class.assignment.submission.submittedResource_GetCount - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/$count': - get: - tags: - - education.educationClass - summary: Get the number of the resource - operationId: education.class.assignment.submission_GetCount - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/classes/{educationClass-id}/assignments/$count': - get: - tags: - - education.educationClass - summary: Get the number of the resource - operationId: education.class.assignment_GetCount - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/classes/{educationClass-id}/assignments/microsoft.graph.delta()': - get: - tags: - - education.educationClass - summary: Invoke function delta - description: Get a list of newly-created or updated assignments without reading the whole collection. A teacher or an application running with application permissions can see all assignment objects for the class. Students can only see assignments that are assigned to them. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-delta?view=graph-rest-1.0 - operationId: education.class.assignment_delta - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Success - content: - application/json: - schema: - title: Collection of educationAssignment - type: object - properties: - value: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - '@odata.nextLink': - type: string - nullable: true - '@odata.deltaLink': - type: string - nullable: true - additionalProperties: - type: object - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: function - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - '/education/classes/{educationClass-id}/assignmentSettings': - get: - tags: - - education.educationClass - summary: Get assignmentSettings from education - description: Specifies class-level assignments settings. - operationId: education.class_GetAssignmentSetting - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignmentSettings' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationClass - summary: Update educationAssignmentSettings - description: Update the properties of an educationAssignmentSettings object. Only teachers can update these settings. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignmentsettings-update?view=graph-rest-1.0 - operationId: education.class_UpdateAssignmentSetting - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignmentSettings' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignmentSettings' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationClass - summary: Delete navigation property assignmentSettings for education - operationId: education.class_DeleteAssignmentSetting - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignmentSettings/gradingCategories': - get: - tags: - - education.educationClass - summary: Get gradingCategories from education - description: 'When set, enables users to weight assignments differently when computing a class average grade.' - operationId: education.class.assignmentSetting_ListGradingCategory - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationGradingCategoryCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationClass - summary: Create new navigation property to gradingCategories for education - operationId: education.class.assignmentSetting_CreateGradingCategory - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationGradingCategory' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationGradingCategory' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignmentSettings/gradingCategories/{educationGradingCategory-id}': - get: - tags: - - education.educationClass - summary: Get gradingCategories from education - description: 'When set, enables users to weight assignments differently when computing a class average grade.' - operationId: education.class.assignmentSetting_GetGradingCategory - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationGradingCategory-id - in: path - description: The unique identifier of educationGradingCategory - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationGradingCategory - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationGradingCategory' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationClass - summary: Update gradingCategory - description: Update a single gradingCategory on the educationAssignmentSettings. Only teachers can perform this operation. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationgradingcategory-update?view=graph-rest-1.0 - operationId: education.class.assignmentSetting_UpdateGradingCategory - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationGradingCategory-id - in: path - description: The unique identifier of educationGradingCategory - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationGradingCategory - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationGradingCategory' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationGradingCategory' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationClass - summary: Delete navigation property gradingCategories for education - operationId: education.class.assignmentSetting_DeleteGradingCategory - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationGradingCategory-id - in: path - description: The unique identifier of educationGradingCategory - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationGradingCategory - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/assignmentSettings/gradingCategories/$count': - get: - tags: - - education.educationClass - summary: Get the number of the resource - operationId: education.class.assignmentSetting.gradingCategory_GetCount - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/classes/{educationClass-id}/group': - get: - tags: - - education.educationClass - summary: Get group from education - description: The underlying Microsoft 365 group object. - operationId: education.class_GetGroup - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.group' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/group/serviceProvisioningErrors': - get: - tags: - - education.educationClass - summary: Get serviceProvisioningErrors property value - description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a group object. Supports $filter (eq, not, for isResolved and serviceInstance).' - operationId: education.class.group_ListServiceProvisioningError - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - '/education/classes/{educationClass-id}/group/serviceProvisioningErrors/$count': - get: - tags: - - education.educationClass - summary: Get the number of the resource - operationId: education.class.group.ServiceProvisioningError_GetCount - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/classes/{educationClass-id}/members': - get: - tags: - - education.educationClass - summary: List members of an educationClass - description: Retrieves the educationUser members of an educationClass. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-list-members?view=graph-rest-1.0 - operationId: education.class_ListMember - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationUserCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/members/{educationUser-id}/$ref': - delete: - tags: - - education.educationClass - summary: Remove member from educationClass - description: Remove an educationUser from an educationClass. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-delete-members?view=graph-rest-1.0 - operationId: education.class.member_DeleteEducationUserGraphBPreRef - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/members/$count': - get: - tags: - - education.educationClass - summary: Get the number of the resource - operationId: education.class.member_GetCount - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/classes/{educationClass-id}/members/$ref': - get: - tags: - - education.educationClass - summary: List members of an educationClass - description: Retrieves the educationUser members of an educationClass. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-list-members?view=graph-rest-1.0 - operationId: education.class_ListMemberGraphBPreRef - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/StringCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationClass - summary: Add a student - description: Add an educationUser member to an educationClass. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-post-members?view=graph-rest-1.0 - operationId: education.class_CreateMemberGraphBPreRef - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - requestBody: - $ref: '#/components/requestBodies/refPostBody' - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationClass - summary: Remove member from educationClass - description: Remove an educationUser from an educationClass. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-delete-members?view=graph-rest-1.0 - operationId: education.class_DeleteMemberGraphBPreRef - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - - name: '@id' - in: query - description: The delete Uri - required: true - style: form - explode: false - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/modules': - get: - tags: - - education.educationClass - summary: List class modules - description: 'Retrieve a list of module objects. Only teachers, students, and applications with application permissions can perform this operation. A teacher or an application with application permissions can see all module objects for the class. Students can only see published modules.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-list-modules?view=graph-rest-1.0 - operationId: education.class_ListModule - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationModuleCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationClass - summary: Create educationModule - description: 'Create a new module in a class. Only teachers in a class can create a module. Modules start in the draft state, which means that students can''t see the modules until publication.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-post-module?view=graph-rest-1.0 - operationId: education.class_CreateModule - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationModule' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationModule' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/modules/{educationModule-id}': - get: - tags: - - education.educationClass - summary: Get educationModule - description: 'Get the properties and relationships of a module. Only teachers, students, and applications with application permissions can perform this operation. Students can only see published modules; teachers and applications with application permissions can see all modules in a class.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationmodule-get?view=graph-rest-1.0 - operationId: education.class_GetModule - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationModule-id - in: path - description: The unique identifier of educationModule - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationModule - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationModule' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationClass - summary: Update educationModule - description: Update an educationModule object in a class. Only teachers in the class can perform this operation. You can't use a PATCH request to change the status of a module. Use the publish action to change the module status. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationmodule-update?view=graph-rest-1.0 - operationId: education.class_UpdateModule - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationModule-id - in: path - description: The unique identifier of educationModule - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationModule - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationModule' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationModule' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationClass - summary: Delete educationModule - description: Delete an existing module in a class. Only teachers within a class can delete modules. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationmodule-delete?view=graph-rest-1.0 - operationId: education.class_DeleteModule - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationModule-id - in: path - description: The unique identifier of educationModule - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationModule - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/modules/{educationModule-id}/microsoft.graph.pin': - post: - tags: - - education.educationClass - summary: Invoke action pin - description: Pin an educationModule in the class work list. This action sets the isPinned property to true for an educationModule. Only teachers can perform this action and only one module at a time can be pinned in the class work list. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationmodule-pin?view=graph-rest-1.0 - operationId: education.class.module_pin - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationModule-id - in: path - description: The unique identifier of educationModule - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationModule - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationModule' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/classes/{educationClass-id}/modules/{educationModule-id}/microsoft.graph.publish': - post: - tags: - - education.educationClass - summary: Invoke action publish - description: 'Change the state of an educationModule from its original draft status to the published status. Only teachers in the class can perform this operation. When a module is in draft status, students can''t see the module. When you call this API, the module appears in the student''s class work list.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationmodule-publish?view=graph-rest-1.0 - operationId: education.class.module_publish - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationModule-id - in: path - description: The unique identifier of educationModule - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationModule - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationModule' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/classes/{educationClass-id}/modules/{educationModule-id}/microsoft.graph.setUpResourcesFolder': - post: - tags: - - education.educationClass - summary: Invoke action setUpResourcesFolder - description: Create a SharePoint folder to upload files for a given educationModule. Only teachers can perform this operation. The teacher determines what resources to upload to the SharePoint folder for the module. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationmodule-setupresourcesfolder?view=graph-rest-1.0 - operationId: education.class.module_setUpResourcesFolder - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationModule-id - in: path - description: The unique identifier of educationModule - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationModule - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationModule' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/classes/{educationClass-id}/modules/{educationModule-id}/microsoft.graph.unpin': - post: - tags: - - education.educationClass - summary: Invoke action unpin - description: Unpin an educationModule in the classwork list. This action sets the isPinned property to false for an educationModule. Only teachers in the class can perform this operation. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationmodule-unpin?view=graph-rest-1.0 - operationId: education.class.module_unpin - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationModule-id - in: path - description: The unique identifier of educationModule - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationModule - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationModule' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/classes/{educationClass-id}/modules/{educationModule-id}/resources': - get: - tags: - - education.educationClass - summary: List module resources - description: 'Get all the educationModuleResource objects associated with a module. Only teachers, students, and applications with application permissions can perform this operation.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationmodule-list-resources?view=graph-rest-1.0 - operationId: education.class.module_ListResource - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationModule-id - in: path - description: The unique identifier of educationModule - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationModule - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationModuleResourceCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationClass - summary: Create educationModuleResource - description: 'Create a resource in a module. Only teachers can perform this operation. You can create the following types of module resources: Every resource has an @odata.type property to indicate which type of resource is being created.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationmodule-post-resources?view=graph-rest-1.0 - operationId: education.class.module_CreateResource - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationModule-id - in: path - description: The unique identifier of educationModule - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationModule - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationModuleResource' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationModuleResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/modules/{educationModule-id}/resources/{educationModuleResource-id}': - get: - tags: - - education.educationClass - summary: Get educationModuleResource - description: 'Get the properties of a resource associated with a module. Only teachers, students, and applications with application permissions can perform this operation.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationmoduleresource-get?view=graph-rest-1.0 - operationId: education.class.module_GetResource - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationModule-id - in: path - description: The unique identifier of educationModule - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationModule - - name: educationModuleResource-id - in: path - description: The unique identifier of educationModuleResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationModuleResource - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationModuleResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationClass - summary: Update educationModuleResource - description: 'Update a resource in a module. Only teachers can perform this operation. The only one property that can be updated is displayName, for all resource types.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationmoduleresource-update?view=graph-rest-1.0 - operationId: education.class.module_UpdateResource - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationModule-id - in: path - description: The unique identifier of educationModule - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationModule - - name: educationModuleResource-id - in: path - description: The unique identifier of educationModuleResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationModuleResource - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationModuleResource' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationModuleResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationClass - summary: Delete educationModuleResource - description: Delete a specific educationModuleResource attached to a module. Only teachers in the class can remove a resource. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationmoduleresource-delete?view=graph-rest-1.0 - operationId: education.class.module_DeleteResource - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationModule-id - in: path - description: The unique identifier of educationModule - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationModule - - name: educationModuleResource-id - in: path - description: The unique identifier of educationModuleResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationModuleResource - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/modules/{educationModule-id}/resources/$count': - get: - tags: - - education.educationClass - summary: Get the number of the resource - operationId: education.class.module.resource_GetCount - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationModule-id - in: path - description: The unique identifier of educationModule - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationModule - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/classes/{educationClass-id}/modules/$count': - get: - tags: - - education.educationClass - summary: Get the number of the resource - operationId: education.class.module_GetCount - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/classes/{educationClass-id}/schools': - get: - tags: - - education.educationClass - summary: List schools - description: Retrieve a list of schools in which the class is taught. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-list-schools?view=graph-rest-1.0 - operationId: education.class_ListSchool - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationSchoolCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/schools/{educationSchool-id}': - get: - tags: - - education.educationClass - summary: Get schools from education - description: All schools that this class is associated with. Nullable. - operationId: education.class_GetSchool - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationSchool-id - in: path - description: The unique identifier of educationSchool - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSchool - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSchool' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/schools/$count': - get: - tags: - - education.educationClass - summary: Get the number of the resource - operationId: education.class.school_GetCount - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/classes/{educationClass-id}/teachers': - get: - tags: - - education.educationClass - summary: List teachers - description: Retrieve a list of teachers for a class. Delegated tokens must be members of the class to get the teacher list. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-list-teachers?view=graph-rest-1.0 - operationId: education.class_ListTeacher - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationUserCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/teachers/{educationUser-id}/$ref': - delete: - tags: - - education.educationClass - summary: Remove teacher from educationClass - description: Remove a teacher from an educationClass. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-delete-teachers?view=graph-rest-1.0 - operationId: education.class.teacher_DeleteEducationUserGraphBPreRef - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/classes/{educationClass-id}/teachers/$count': - get: - tags: - - education.educationClass - summary: Get the number of the resource - operationId: education.class.teacher_GetCount - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/classes/{educationClass-id}/teachers/$ref': - get: - tags: - - education.educationClass - summary: List teachers - description: Retrieve a list of teachers for a class. Delegated tokens must be members of the class to get the teacher list. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-list-teachers?view=graph-rest-1.0 - operationId: education.class_ListTeacherGraphBPreRef - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/StringCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationClass - summary: Add teacher - description: Add a teacher to a class. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-post-teachers?view=graph-rest-1.0 - operationId: education.class_CreateTeacherGraphBPreRef - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - requestBody: - $ref: '#/components/requestBodies/refPostBody' - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationClass - summary: Remove teacher from educationClass - description: Remove a teacher from an educationClass. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-delete-teachers?view=graph-rest-1.0 - operationId: education.class_DeleteTeacherGraphBPreRef - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - - name: '@id' - in: query - description: The delete Uri - required: true - style: form - explode: false - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - /education/classes/$count: - get: - tags: - - education.educationClass - summary: Get the number of the resource - operationId: education.class_GetCount - parameters: - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - /education/classes/microsoft.graph.delta(): - get: - tags: - - education.educationClass - summary: Invoke function delta - description: 'Get newly created or updated classes, including membership changes, without having to perform a full read of the entire class collection. See Use delta query for details.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationclass-delta?view=graph-rest-1.0 - operationId: education.class_delta - parameters: - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Success - content: - application/json: - schema: - title: Collection of educationClass - type: object - properties: - value: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.educationClass' - '@odata.nextLink': - type: string - nullable: true - '@odata.deltaLink': - type: string - nullable: true - additionalProperties: - type: object - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: function - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - /education/me: - get: - tags: - - education.educationUser - summary: Get me from education - operationId: education_GetMe - parameters: - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationUser' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationUser - summary: Update the navigation property me in education - operationId: education_UpdateMe - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationUser' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationUser' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete navigation property me for education - operationId: education_DeleteMe - parameters: - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - /education/me/assignments: - get: - tags: - - education.educationUser - summary: List assignments of a user - description: 'Returns a list of educationAssignment assigned to a educationUser for all classes. Only teachers, students, and applications with application permissions can perform this operation. This method allows a caller to find all the assignments belonging to a student or a teacher in a single call rather than having to request assignments from each class. The assignment list contains what is needed to get the detailed information for the assignment from within the class namespace. Use the methods defined for the assignment for all other operations.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationuser-list-assignments?view=graph-rest-1.0 - operationId: education.me_ListAssignment - parameters: - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationAssignmentCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationUser - summary: Create new navigation property to assignments for education - operationId: education.me_CreateAssignment - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/me/assignments/{educationAssignment-id}': - get: - tags: - - education.educationUser - summary: Get assignments from education - description: Assignments belonging to the user. - operationId: education.me_GetAssignment - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationUser - summary: Update the navigation property assignments in education - operationId: education.me_UpdateAssignment - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete navigation property assignments for education - operationId: education.me_DeleteAssignment - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/me/assignments/{educationAssignment-id}/categories': - get: - tags: - - education.educationUser - summary: Get categories from education - description: 'When set, enables users to easily find assignments of a given type. Read-only. Nullable.' - operationId: education.me.assignment_ListCategory - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationCategoryCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationUser - summary: Create new navigation property to categories for education - operationId: education.me.assignment_CreateCategory - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationCategory' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationCategory' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/me/assignments/{educationAssignment-id}/categories/{educationCategory-id}/$ref': - delete: - tags: - - education.educationUser - summary: Delete ref of navigation property categories for education - operationId: education.me.assignment.category_DeleteEducationCategoryGraphBPreRef - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationCategory-id - in: path - description: The unique identifier of educationCategory - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationCategory - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/me/assignments/{educationAssignment-id}/categories/$count': - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.me.assignment.category_GetCount - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/me/assignments/{educationAssignment-id}/categories/$ref': - get: - tags: - - education.educationUser - summary: Get ref of categories from education - description: 'When set, enables users to easily find assignments of a given type. Read-only. Nullable.' - operationId: education.me.assignment_ListCategoryGraphBPreRef - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/StringCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationUser - summary: Create new navigation property ref to categories for education - operationId: education.me.assignment_CreateCategoryGraphBPreRef - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - requestBody: - $ref: '#/components/requestBodies/refPostBody' - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete ref of navigation property categories for education - operationId: education.me.assignment_DeleteCategoryGraphBPreRef - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - - name: '@id' - in: query - description: The delete Uri - required: true - style: form - explode: false - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/me/assignments/{educationAssignment-id}/categories/microsoft.graph.delta()': - get: - tags: - - education.educationUser - summary: Invoke function delta - description: Get a list of newly created or updated educationCategory objects without having to perform a full read of the collection. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationcategory-delta?view=graph-rest-1.0 - operationId: education.me.assignment.category_delta - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Success - content: - application/json: - schema: - title: Collection of educationCategory - type: object - properties: - value: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.educationCategory' - '@odata.nextLink': - type: string - nullable: true - '@odata.deltaLink': - type: string - nullable: true - additionalProperties: - type: object - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: function - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - '/education/me/assignments/{educationAssignment-id}/gradingCategory': - get: - tags: - - education.educationUser - summary: Get gradingCategory from education - description: 'When set, enables users to weight assignments differently when computing a class average grade.' - operationId: education.me.assignment_GetGradingCategory - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationGradingCategory' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/me/assignments/{educationAssignment-id}/microsoft.graph.activate': - post: - tags: - - education.educationUser - summary: Invoke action activate - description: Activate an inactive educationAssignment to signal that the assignment has further action items for teachers or students. This action can only be performed by a teacher on currently inactive assignments. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-activate?view=graph-rest-1.0 - operationId: education.me.assignment_activate - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/me/assignments/{educationAssignment-id}/microsoft.graph.deactivate': - post: - tags: - - education.educationUser - summary: Invoke action deactivate - description: Mark an assigned educationAssignment as inactive to signal that the assignment has no further action items for teachers and students. This action can only be performed by a teacher on assigned assignments. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-deactivate?view=graph-rest-1.0 - operationId: education.me.assignment_deactivate - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/me/assignments/{educationAssignment-id}/microsoft.graph.publish': - post: - tags: - - education.educationUser - summary: Invoke action publish - description: 'Publish an education assignment. Change the status of an educationAssignment from its original draft status to the published status. You can change the status from draft to scheduled if the assignment is scheduled for a future date. Only a teacher in the class can make this call. When an assignment is in draft status, students will not see the assignment, nor will there be any submission objects. Calling this API creates educationSubmission objects and displays the assignment in each student''s list. The status of the assignment goes back to draft if there is any backend failure during publish process. To update the properties of a published assignment, see update an assignment.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-publish?view=graph-rest-1.0 - operationId: education.me.assignment_publish - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/me/assignments/{educationAssignment-id}/microsoft.graph.setUpFeedbackResourcesFolder': - post: - tags: - - education.educationUser - summary: Invoke action setUpFeedbackResourcesFolder - description: Create a SharePoint folder to upload feedback files for a given educationSubmission. Only teachers can perform this operation. The teacher determines the resources to upload in the feedback resources folder of a submission. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-setupfeedbackresourcesfolder?view=graph-rest-1.0 - operationId: education.me.assignment_setUpFeedbackResourcesFolder - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/me/assignments/{educationAssignment-id}/microsoft.graph.setUpResourcesFolder': - post: - tags: - - education.educationUser - summary: Invoke action setUpResourcesFolder - description: 'Create a SharePoint folder to upload files for a given educationAssignment. Only teachers can perform this operation. The teacher determines the resources to upload in the assignment''s folder. ' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-setupresourcesfolder?view=graph-rest-1.0 - operationId: education.me.assignment_setUpResourcesFolder - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/me/assignments/{educationAssignment-id}/resources': - get: - tags: - - education.educationUser - summary: Get resources from education - description: Learning objects that are associated with this assignment. Only teachers can modify this list. Nullable. - operationId: education.me.assignment_ListResource - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationAssignmentResourceCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationUser - summary: Create new navigation property to resources for education - operationId: education.me.assignment_CreateResource - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/me/assignments/{educationAssignment-id}/resources/{educationAssignmentResource-id}': - get: - tags: - - education.educationUser - summary: Get resources from education - description: Learning objects that are associated with this assignment. Only teachers can modify this list. Nullable. - operationId: education.me.assignment_GetResource - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationAssignmentResource-id - in: path - description: The unique identifier of educationAssignmentResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignmentResource - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationUser - summary: Update the navigation property resources in education - operationId: education.me.assignment_UpdateResource - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationAssignmentResource-id - in: path - description: The unique identifier of educationAssignmentResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignmentResource - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete navigation property resources for education - operationId: education.me.assignment_DeleteResource - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationAssignmentResource-id - in: path - description: The unique identifier of educationAssignmentResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignmentResource - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/me/assignments/{educationAssignment-id}/resources/$count': - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.me.assignment.resource_GetCount - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/me/assignments/{educationAssignment-id}/rubric': - get: - tags: - - education.educationUser - summary: Get rubric from education - description: 'When set, the grading rubric attached to this assignment.' - operationId: education.me.assignment_GetRubric - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRubric' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationUser - summary: Update the navigation property rubric in education - operationId: education.me.assignment_UpdateRubric - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRubric' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRubric' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete navigation property rubric for education - operationId: education.me.assignment_DeleteRubric - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/me/assignments/{educationAssignment-id}/rubric/$ref': - get: - tags: - - education.educationUser - summary: Get ref of rubric from education - description: 'When set, the grading rubric attached to this assignment.' - operationId: education.me.assignment_GetRubricGraphBPreRef - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - responses: - 2XX: - description: Retrieved navigation property link - content: - application/json: - schema: - type: string - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - put: - tags: - - education.educationUser - summary: Update the ref of navigation property rubric in education - operationId: education.me.assignment_SetRubricGraphBPreRef - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - requestBody: - $ref: '#/components/requestBodies/refPutBody' - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete ref of navigation property rubric for education - operationId: education.me.assignment_DeleteRubricGraphBPreRef - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/me/assignments/{educationAssignment-id}/submissions': - get: - tags: - - education.educationUser - summary: Get submissions from education - description: 'Once published, there''s a submission object for each student representing their work and grade. Read-only. Nullable.' - operationId: education.me.assignment_ListSubmission - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationSubmissionCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationUser - summary: Create new navigation property to submissions for education - operationId: education.me.assignment_CreateSubmission - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}': - get: - tags: - - education.educationUser - summary: Get submissions from education - description: 'Once published, there''s a submission object for each student representing their work and grade. Read-only. Nullable.' - operationId: education.me.assignment_GetSubmission - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationUser - summary: Update the navigation property submissions in education - operationId: education.me.assignment_UpdateSubmission - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete navigation property submissions for education - operationId: education.me.assignment_DeleteSubmission - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.excuse': - post: - tags: - - education.educationUser - summary: Invoke action excuse - description: 'Excuse a submission. Excused submissions aren''t included in average grade calculations. Grading rubrics and feedback are deleted. Only teachers can perform this action. If the Prefer: include-unknown-enum-members request header is provided, the excused submission shows the excused status. Otherwise, the submission status retains the returned status. For more information about how to use this header, see the Examples section.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-excuse?view=graph-rest-1.0 - operationId: education.me.assignment.submission_excuse - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.reassign': - post: - tags: - - education.educationUser - summary: Invoke action reassign - description: 'Reassign the submission to the student with feedback for review. Only teachers can perform this action. Include the Prefer: include-unknown-enum-members header when you call this method; otherwise, a reassigned submission is treated as a returned submission. This means that the reassigned status is mapped to the returned status, and reassignedDateTime and reassignedBy properties are mapped to returnedDateTime and returnedBy respectively. If the header Prefer: include-unknown-enum-members is provided, a reassigned submission retains the reassigned status. For details, see the examples section.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-reassign?view=graph-rest-1.0 - operationId: education.me.assignment.submission_reassign - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.return': - post: - tags: - - education.educationUser - summary: Invoke action return - description: Make the grade and feedback associated with this submission available to the student. This action changes the status of the submission from 'submitted' to 'returned' and indicates that feedback is provided or grading is done. This action can only be done by the teacher. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-return?view=graph-rest-1.0 - operationId: education.me.assignment.submission_return - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.setUpResourcesFolder': - post: - tags: - - education.educationUser - summary: Invoke action setUpResourcesFolder - description: 'Trigger the creation of the SharePoint resource folder where all file-based resources (Word, Excel, and so on) should be uploaded for a given submission. Only teachers and students can perform this operation. Note that files must be located in this folder in order to be added as resources. Only a student in the class can determine what files to upload in a given submission-level resource folder. ' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-setupresourcesfolder?view=graph-rest-1.0 - operationId: education.me.assignment.submission_setUpResourcesFolder - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.submit': - post: - tags: - - education.educationUser - summary: Invoke action submit - description: 'Indicate that a student is done with the work and is ready to hand in the assignment. Only teachers, students, and applications with application permissions can perform this operation. This method changes the status of the submission from working to submitted. During the submit process, all the resources are copied to the submittedResources bucket. The teacher will be looking at the submitted resources list for grading. A teacher can also submit a student''s assignment on their behalf.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-submit?view=graph-rest-1.0 - operationId: education.me.assignment.submission_submit - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.unsubmit': - post: - tags: - - education.educationUser - summary: Invoke action unsubmit - description: 'Indicate that a student wants to work on the submission of the assignment after it was turned in. Only teachers, students, and applications with application permissions can perform this operation. This method changes the status of the submission from submitted to working. During the submit process, all the resources are copied from submittedResources to workingResources. The teacher will be looking at the working resources list for grading. A teacher can also unsubmit a student''s assignment on their behalf.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-unsubmit?view=graph-rest-1.0 - operationId: education.me.assignment.submission_unsubmit - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/outcomes': - get: - tags: - - education.educationUser - summary: Get outcomes from education - operationId: education.me.assignment.submission_ListOutcome - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationOutcomeCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationUser - summary: Create new navigation property to outcomes for education - operationId: education.me.assignment.submission_CreateOutcome - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationOutcome' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationOutcome' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/outcomes/{educationOutcome-id}': - get: - tags: - - education.educationUser - summary: Get outcomes from education - operationId: education.me.assignment.submission_GetOutcome - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationOutcome-id - in: path - description: The unique identifier of educationOutcome - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationOutcome - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationOutcome' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationUser - summary: Update the navigation property outcomes in education - operationId: education.me.assignment.submission_UpdateOutcome - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationOutcome-id - in: path - description: The unique identifier of educationOutcome - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationOutcome - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationOutcome' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationOutcome' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete navigation property outcomes for education - operationId: education.me.assignment.submission_DeleteOutcome - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationOutcome-id - in: path - description: The unique identifier of educationOutcome - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationOutcome - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/outcomes/$count': - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.me.assignment.submission.outcome_GetCount - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/resources': - get: - tags: - - education.educationUser - summary: Get resources from education - operationId: education.me.assignment.submission_ListResource - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationSubmissionResourceCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationUser - summary: Create new navigation property to resources for education - operationId: education.me.assignment.submission_CreateResource - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/resources/{educationSubmissionResource-id}': - get: - tags: - - education.educationUser - summary: Get resources from education - operationId: education.me.assignment.submission_GetResource - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationSubmissionResource-id - in: path - description: The unique identifier of educationSubmissionResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmissionResource - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationUser - summary: Update the navigation property resources in education - operationId: education.me.assignment.submission_UpdateResource - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationSubmissionResource-id - in: path - description: The unique identifier of educationSubmissionResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmissionResource - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete navigation property resources for education - operationId: education.me.assignment.submission_DeleteResource - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationSubmissionResource-id - in: path - description: The unique identifier of educationSubmissionResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmissionResource - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/resources/$count': - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.me.assignment.submission.resource_GetCount - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/submittedResources': - get: - tags: - - education.educationUser - summary: Get submittedResources from education - operationId: education.me.assignment.submission_ListSubmittedResource - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationSubmissionResourceCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationUser - summary: Create new navigation property to submittedResources for education - operationId: education.me.assignment.submission_CreateSubmittedResource - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/submittedResources/{educationSubmissionResource-id}': - get: - tags: - - education.educationUser - summary: Get submittedResources from education - operationId: education.me.assignment.submission_GetSubmittedResource - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationSubmissionResource-id - in: path - description: The unique identifier of educationSubmissionResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmissionResource - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationUser - summary: Update the navigation property submittedResources in education - operationId: education.me.assignment.submission_UpdateSubmittedResource - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationSubmissionResource-id - in: path - description: The unique identifier of educationSubmissionResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmissionResource - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete navigation property submittedResources for education - operationId: education.me.assignment.submission_DeleteSubmittedResource - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationSubmissionResource-id - in: path - description: The unique identifier of educationSubmissionResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmissionResource - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/submittedResources/$count': - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.me.assignment.submission.submittedResource_GetCount - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/me/assignments/{educationAssignment-id}/submissions/$count': - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.me.assignment.submission_GetCount - parameters: - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - /education/me/assignments/$count: - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.me.assignment_GetCount - parameters: - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - /education/me/assignments/microsoft.graph.delta(): - get: - tags: - - education.educationUser - summary: Invoke function delta - description: Get a list of newly-created or updated assignments without reading the whole collection. A teacher or an application running with application permissions can see all assignment objects for the class. Students can only see assignments that are assigned to them. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-delta?view=graph-rest-1.0 - operationId: education.me.assignment_delta - parameters: - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Success - content: - application/json: - schema: - title: Collection of educationAssignment - type: object - properties: - value: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - '@odata.nextLink': - type: string - nullable: true - '@odata.deltaLink': - type: string - nullable: true - additionalProperties: - type: object - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: function - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - /education/me/classes: - get: - tags: - - education.educationUser - summary: List classes of an educationUser - description: Get the educationClass resources an educationUser is a member of. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationuser-list-classes?view=graph-rest-1.0 - operationId: education.me_ListClass - parameters: - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationClassCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - '/education/me/classes/{educationClass-id}': - get: - tags: - - education.educationUser - summary: Get classes from education - description: Classes to which the user belongs. Nullable. - operationId: education.me_GetClass - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationClass' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - /education/me/classes/$count: - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.me.class_GetCount - parameters: - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - /education/me/rubrics: - get: - tags: - - education.educationUser - summary: List rubrics - description: Retrieve a list of educationRubric objects. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationuser-list-rubrics?view=graph-rest-1.0 - operationId: education.me_ListRubric - parameters: - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationRubricCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationUser - summary: Create educationRubric - description: Create a new educationRubric object. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationuser-post-rubrics?view=graph-rest-1.0 - operationId: education.me_CreateRubric - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRubric' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRubric' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/me/rubrics/{educationRubric-id}': - get: - tags: - - education.educationUser - summary: Get educationRubric - description: Retrieve the properties and relationships of an educationRubric object. Only teachers and students can perform this operation. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationrubric-get?view=graph-rest-1.0 - operationId: education.me_GetRubric - parameters: - - name: educationRubric-id - in: path - description: The unique identifier of educationRubric - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationRubric - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRubric' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationUser - summary: Update educationRubric - description: 'Update the properties of an educationRubric object. Only teachers can perform this operation. Updating a rubric attached to an assignment (PATCH /education/classes/{class-id}/assignments/{assignment-id}/rubric) is only possible before the assignment is published, and what is updated is actually the original rubric that exists under /education/users/{id}/rubrics. After the assignment is published, an immutable copy of the rubric is made that is attached to that specific assignment. That rubric can be retrieved using GET /education/classes/{class-id}/assignments/{assignment-id}/rubric, but it can''t be updated.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationrubric-update?view=graph-rest-1.0 - operationId: education.me_UpdateRubric - parameters: - - name: educationRubric-id - in: path - description: The unique identifier of educationRubric - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationRubric - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRubric' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRubric' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete educationRubric - description: Delete an educationRubric object. Only teachers can perform this operation. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationrubric-delete?view=graph-rest-1.0 - operationId: education.me_DeleteRubric - parameters: - - name: educationRubric-id - in: path - description: The unique identifier of educationRubric - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationRubric - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - /education/me/rubrics/$count: - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.me.rubric_GetCount - parameters: - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - /education/me/schools: - get: - tags: - - education.educationUser - summary: List schools of an educationUser - description: Retrieve a list of schools for a user. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationuser-list-schools?view=graph-rest-1.0 - operationId: education.me_ListSchool - parameters: - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationSchoolCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - '/education/me/schools/{educationSchool-id}': - get: - tags: - - education.educationUser - summary: Get schools from education - description: Schools to which the user belongs. Nullable. - operationId: education.me_GetSchool - parameters: - - name: educationSchool-id - in: path - description: The unique identifier of educationSchool - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSchool - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSchool' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - /education/me/schools/$count: - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.me.school_GetCount - parameters: - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - /education/me/taughtClasses: - get: - tags: - - education.educationUser - summary: Get taughtClasses from education - description: Classes for which the user is a teacher. - operationId: education.me_ListTaughtClass - parameters: - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationClassCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - '/education/me/taughtClasses/{educationClass-id}': - get: - tags: - - education.educationUser - summary: Get taughtClasses from education - description: Classes for which the user is a teacher. - operationId: education.me_GetTaughtClass - parameters: - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationClass' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - /education/me/taughtClasses/$count: - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.me.taughtClass_GetCount - parameters: - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - /education/me/user: - get: - tags: - - education.educationUser - summary: Get educationUser - description: Retrieve the simple directory user that corresponds to this educationUser. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationuser-get-user?view=graph-rest-1.0 - operationId: education.me_GetUser - parameters: - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.user' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - /education/me/user/mailboxSettings: - get: - tags: - - education.educationUser - summary: Get mailboxSettings property value - description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Returned only on $select.' - operationId: education.me.user_GetMailboxSetting - parameters: - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Entity result. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.mailboxSettings' - default: - $ref: '#/components/responses/error' - patch: - tags: - - education.educationUser - summary: Update property mailboxSettings value. - operationId: education.me.user_UpdateMailboxSetting - requestBody: - description: New property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.mailboxSettings' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.mailboxSettings' - default: - $ref: '#/components/responses/error' - /education/me/user/serviceProvisioningErrors: - get: - tags: - - education.educationUser - summary: Get serviceProvisioningErrors property value - description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).' - operationId: education.me.user_ListServiceProvisioningError - parameters: - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - /education/me/user/serviceProvisioningErrors/$count: - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.me.user.ServiceProvisioningError_GetCount - parameters: - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - /education/schools: - get: - tags: - - education.educationSchool - summary: List educationSchools - description: Get a list of the educationSchool objects and their properties. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationschool-list?view=graph-rest-1.0 - operationId: education_ListSchool - parameters: - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationSchoolCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationSchool - summary: Create educationSchool - description: Create a new educationSchool object. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationschool-post?view=graph-rest-1.0 - operationId: education_CreateSchool - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSchool' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSchool' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/schools/{educationSchool-id}': - get: - tags: - - education.educationSchool - summary: Get educationSchool - description: Read the properties and relationships of an educationSchool object. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationschool-get?view=graph-rest-1.0 - operationId: education_GetSchool - parameters: - - name: educationSchool-id - in: path - description: The unique identifier of educationSchool - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSchool - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSchool' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationSchool - summary: Update educationSchool - description: Update the properties of an educationSchool object. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationschool-update?view=graph-rest-1.0 - operationId: education_UpdateSchool - parameters: - - name: educationSchool-id - in: path - description: The unique identifier of educationSchool - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSchool - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSchool' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSchool' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationSchool - summary: Delete educationSchool - description: Delete a school. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationschool-delete?view=graph-rest-1.0 - operationId: education_DeleteSchool - parameters: - - name: educationSchool-id - in: path - description: The unique identifier of educationSchool - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSchool - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/schools/{educationSchool-id}/administrativeUnit': - get: - tags: - - education.educationSchool - summary: Get administrativeUnit from education - description: The underlying administrativeUnit for this school. - operationId: education.school_GetAdministrativeUnit - parameters: - - name: educationSchool-id - in: path - description: The unique identifier of educationSchool - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSchool - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.administrativeUnit' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationSchool - summary: Update the navigation property administrativeUnit in education - operationId: education.school_UpdateAdministrativeUnit - parameters: - - name: educationSchool-id - in: path - description: The unique identifier of educationSchool - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSchool - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.administrativeUnit' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.administrativeUnit' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/schools/{educationSchool-id}/classes': - get: - tags: - - education.educationSchool - summary: List classes of an educationSchool - description: Get the educationClass resources owned by an educationSchool. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationschool-list-classes?view=graph-rest-1.0 - operationId: education.school_ListClass - parameters: - - name: educationSchool-id - in: path - description: The unique identifier of educationSchool - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSchool - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationClassCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - '/education/schools/{educationSchool-id}/classes/{educationClass-id}/$ref': - delete: - tags: - - education.educationSchool - summary: Remove educationClass - description: Delete a class from a school. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationschool-delete-classes?view=graph-rest-1.0 - operationId: education.school.class_DeleteEducationClassGraphBPreRef - parameters: - - name: educationSchool-id - in: path - description: The unique identifier of educationSchool - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSchool - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/schools/{educationSchool-id}/classes/$count': - get: - tags: - - education.educationSchool - summary: Get the number of the resource - operationId: education.school.class_GetCount - parameters: - - name: educationSchool-id - in: path - description: The unique identifier of educationSchool - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSchool - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/schools/{educationSchool-id}/classes/$ref': - get: - tags: - - education.educationSchool - summary: List classes of an educationSchool - description: Get the educationClass resources owned by an educationSchool. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationschool-list-classes?view=graph-rest-1.0 - operationId: education.school_ListClassGraphBPreRef - parameters: - - name: educationSchool-id - in: path - description: The unique identifier of educationSchool - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSchool - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/StringCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationSchool - summary: Add educationClass to educationSchool - description: Add a class to a school. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationschool-post-classes?view=graph-rest-1.0 - operationId: education.school_CreateClassGraphBPreRef - parameters: - - name: educationSchool-id - in: path - description: The unique identifier of educationSchool - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSchool - requestBody: - $ref: '#/components/requestBodies/refPostBody' - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationSchool - summary: Remove educationClass - description: Delete a class from a school. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationschool-delete-classes?view=graph-rest-1.0 - operationId: education.school_DeleteClassGraphBPreRef - parameters: - - name: educationSchool-id - in: path - description: The unique identifier of educationSchool - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSchool - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - - name: '@id' - in: query - description: The delete Uri - required: true - style: form - explode: false - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/schools/{educationSchool-id}/users': - get: - tags: - - education.educationSchool - summary: List users of an educationSchool - description: Get the educationUser resources associated with an educationSchool. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationschool-list-users?view=graph-rest-1.0 - operationId: education.school_ListUser - parameters: - - name: educationSchool-id - in: path - description: The unique identifier of educationSchool - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSchool - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationUserCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - '/education/schools/{educationSchool-id}/users/{educationUser-id}/$ref': - delete: - tags: - - education.educationSchool - summary: Remove educationUser from an educationSchool - description: Delete a user from a school. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationschool-delete-users?view=graph-rest-1.0 - operationId: education.school.user_DeleteEducationUserGraphBPreRef - parameters: - - name: educationSchool-id - in: path - description: The unique identifier of educationSchool - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSchool - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/schools/{educationSchool-id}/users/$count': - get: - tags: - - education.educationSchool - summary: Get the number of the resource - operationId: education.school.user_GetCount - parameters: - - name: educationSchool-id - in: path - description: The unique identifier of educationSchool - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSchool - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/schools/{educationSchool-id}/users/$ref': - get: - tags: - - education.educationSchool - summary: List users of an educationSchool - description: Get the educationUser resources associated with an educationSchool. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationschool-list-users?view=graph-rest-1.0 - operationId: education.school_ListUserGraphBPreRef - parameters: - - name: educationSchool-id - in: path - description: The unique identifier of educationSchool - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSchool - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/StringCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationSchool - summary: Add educationUser to an educationSchool - description: Add a user to a school. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationschool-post-users?view=graph-rest-1.0 - operationId: education.school_CreateUserGraphBPreRef - parameters: - - name: educationSchool-id - in: path - description: The unique identifier of educationSchool - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSchool - requestBody: - $ref: '#/components/requestBodies/refPostBody' - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationSchool - summary: Remove educationUser from an educationSchool - description: Delete a user from a school. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationschool-delete-users?view=graph-rest-1.0 - operationId: education.school_DeleteUserGraphBPreRef - parameters: - - name: educationSchool-id - in: path - description: The unique identifier of educationSchool - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSchool - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - - name: '@id' - in: query - description: The delete Uri - required: true - style: form - explode: false - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - /education/schools/$count: - get: - tags: - - education.educationSchool - summary: Get the number of the resource - operationId: education.school_GetCount - parameters: - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - /education/schools/microsoft.graph.delta(): - get: - tags: - - education.educationSchool - summary: Invoke function delta - description: Get newly created or updated schools without having to perform a full read of the entire school collection. See Use delta query for details. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationschool-delta?view=graph-rest-1.0 - operationId: education.school_delta - parameters: - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Success - content: - application/json: - schema: - title: Collection of educationSchool - type: object - properties: - value: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.educationSchool' - '@odata.nextLink': - type: string - nullable: true - '@odata.deltaLink': - type: string - nullable: true - additionalProperties: - type: object - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: function - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - /education/users: - get: - tags: - - education.educationUser - summary: List educationUsers - description: Get a list of the educationUser objects and their properties. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationuser-list?view=graph-rest-1.0 - operationId: education_ListUser - parameters: - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationUserCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationUser - summary: Create educationUser - description: Create a new educationUser object. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationuser-post?view=graph-rest-1.0 - operationId: education_CreateUser - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationUser' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationUser' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}': - get: - tags: - - education.educationUser - summary: Get educationUser - description: Read the properties and relationships of an educationUser object. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationuser-get?view=graph-rest-1.0 - operationId: education_GetUser - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationUser' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationUser - summary: Update educationUser - description: Update the properties of an educationUser object. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationuser-update?view=graph-rest-1.0 - operationId: education_UpdateUser - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationUser' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationUser' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete educationUser - description: Delete a user. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationuser-delete?view=graph-rest-1.0 - operationId: education_DeleteUser - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/assignments': - get: - tags: - - education.educationUser - summary: List assignments of a user - description: 'Returns a list of educationAssignment assigned to a educationUser for all classes. Only teachers, students, and applications with application permissions can perform this operation. This method allows a caller to find all the assignments belonging to a student or a teacher in a single call rather than having to request assignments from each class. The assignment list contains what is needed to get the detailed information for the assignment from within the class namespace. Use the methods defined for the assignment for all other operations.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationuser-list-assignments?view=graph-rest-1.0 - operationId: education.user_ListAssignment - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationAssignmentCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationUser - summary: Create new navigation property to assignments for education - operationId: education.user_CreateAssignment - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}': - get: - tags: - - education.educationUser - summary: Get assignments from education - description: Assignments belonging to the user. - operationId: education.user_GetAssignment - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationUser - summary: Update the navigation property assignments in education - operationId: education.user_UpdateAssignment - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete navigation property assignments for education - operationId: education.user_DeleteAssignment - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/categories': - get: - tags: - - education.educationUser - summary: Get categories from education - description: 'When set, enables users to easily find assignments of a given type. Read-only. Nullable.' - operationId: education.user.assignment_ListCategory - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationCategoryCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationUser - summary: Create new navigation property to categories for education - operationId: education.user.assignment_CreateCategory - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationCategory' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationCategory' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/categories/{educationCategory-id}/$ref': - delete: - tags: - - education.educationUser - summary: Delete ref of navigation property categories for education - operationId: education.user.assignment.category_DeleteEducationCategoryGraphBPreRef - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationCategory-id - in: path - description: The unique identifier of educationCategory - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationCategory - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/categories/$count': - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.user.assignment.category_GetCount - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/categories/$ref': - get: - tags: - - education.educationUser - summary: Get ref of categories from education - description: 'When set, enables users to easily find assignments of a given type. Read-only. Nullable.' - operationId: education.user.assignment_ListCategoryGraphBPreRef - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/StringCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationUser - summary: Create new navigation property ref to categories for education - operationId: education.user.assignment_CreateCategoryGraphBPreRef - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - requestBody: - $ref: '#/components/requestBodies/refPostBody' - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete ref of navigation property categories for education - operationId: education.user.assignment_DeleteCategoryGraphBPreRef - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - - name: '@id' - in: query - description: The delete Uri - required: true - style: form - explode: false - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/categories/microsoft.graph.delta()': - get: - tags: - - education.educationUser - summary: Invoke function delta - description: Get a list of newly created or updated educationCategory objects without having to perform a full read of the collection. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationcategory-delta?view=graph-rest-1.0 - operationId: education.user.assignment.category_delta - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Success - content: - application/json: - schema: - title: Collection of educationCategory - type: object - properties: - value: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.educationCategory' - '@odata.nextLink': - type: string - nullable: true - '@odata.deltaLink': - type: string - nullable: true - additionalProperties: - type: object - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: function - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/gradingCategory': - get: - tags: - - education.educationUser - summary: Get gradingCategory from education - description: 'When set, enables users to weight assignments differently when computing a class average grade.' - operationId: education.user.assignment_GetGradingCategory - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationGradingCategory' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/microsoft.graph.activate': - post: - tags: - - education.educationUser - summary: Invoke action activate - description: Activate an inactive educationAssignment to signal that the assignment has further action items for teachers or students. This action can only be performed by a teacher on currently inactive assignments. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-activate?view=graph-rest-1.0 - operationId: education.user.assignment_activate - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/microsoft.graph.deactivate': - post: - tags: - - education.educationUser - summary: Invoke action deactivate - description: Mark an assigned educationAssignment as inactive to signal that the assignment has no further action items for teachers and students. This action can only be performed by a teacher on assigned assignments. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-deactivate?view=graph-rest-1.0 - operationId: education.user.assignment_deactivate - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/microsoft.graph.publish': - post: - tags: - - education.educationUser - summary: Invoke action publish - description: 'Publish an education assignment. Change the status of an educationAssignment from its original draft status to the published status. You can change the status from draft to scheduled if the assignment is scheduled for a future date. Only a teacher in the class can make this call. When an assignment is in draft status, students will not see the assignment, nor will there be any submission objects. Calling this API creates educationSubmission objects and displays the assignment in each student''s list. The status of the assignment goes back to draft if there is any backend failure during publish process. To update the properties of a published assignment, see update an assignment.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-publish?view=graph-rest-1.0 - operationId: education.user.assignment_publish - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/microsoft.graph.setUpFeedbackResourcesFolder': - post: - tags: - - education.educationUser - summary: Invoke action setUpFeedbackResourcesFolder - description: Create a SharePoint folder to upload feedback files for a given educationSubmission. Only teachers can perform this operation. The teacher determines the resources to upload in the feedback resources folder of a submission. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-setupfeedbackresourcesfolder?view=graph-rest-1.0 - operationId: education.user.assignment_setUpFeedbackResourcesFolder - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/microsoft.graph.setUpResourcesFolder': - post: - tags: - - education.educationUser - summary: Invoke action setUpResourcesFolder - description: 'Create a SharePoint folder to upload files for a given educationAssignment. Only teachers can perform this operation. The teacher determines the resources to upload in the assignment''s folder. ' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-setupresourcesfolder?view=graph-rest-1.0 - operationId: education.user.assignment_setUpResourcesFolder - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/resources': - get: - tags: - - education.educationUser - summary: Get resources from education - description: Learning objects that are associated with this assignment. Only teachers can modify this list. Nullable. - operationId: education.user.assignment_ListResource - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationAssignmentResourceCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationUser - summary: Create new navigation property to resources for education - operationId: education.user.assignment_CreateResource - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/resources/{educationAssignmentResource-id}': - get: - tags: - - education.educationUser - summary: Get resources from education - description: Learning objects that are associated with this assignment. Only teachers can modify this list. Nullable. - operationId: education.user.assignment_GetResource - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationAssignmentResource-id - in: path - description: The unique identifier of educationAssignmentResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignmentResource - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationUser - summary: Update the navigation property resources in education - operationId: education.user.assignment_UpdateResource - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationAssignmentResource-id - in: path - description: The unique identifier of educationAssignmentResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignmentResource - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete navigation property resources for education - operationId: education.user.assignment_DeleteResource - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationAssignmentResource-id - in: path - description: The unique identifier of educationAssignmentResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignmentResource - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/resources/$count': - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.user.assignment.resource_GetCount - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/rubric': - get: - tags: - - education.educationUser - summary: Get rubric from education - description: 'When set, the grading rubric attached to this assignment.' - operationId: education.user.assignment_GetRubric - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRubric' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationUser - summary: Update the navigation property rubric in education - operationId: education.user.assignment_UpdateRubric - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRubric' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRubric' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete navigation property rubric for education - operationId: education.user.assignment_DeleteRubric - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/rubric/$ref': - get: - tags: - - education.educationUser - summary: Get ref of rubric from education - description: 'When set, the grading rubric attached to this assignment.' - operationId: education.user.assignment_GetRubricGraphBPreRef - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - responses: - 2XX: - description: Retrieved navigation property link - content: - application/json: - schema: - type: string - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - put: - tags: - - education.educationUser - summary: Update the ref of navigation property rubric in education - operationId: education.user.assignment_SetRubricGraphBPreRef - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - requestBody: - $ref: '#/components/requestBodies/refPutBody' - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete ref of navigation property rubric for education - operationId: education.user.assignment_DeleteRubricGraphBPreRef - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions': - get: - tags: - - education.educationUser - summary: Get submissions from education - description: 'Once published, there''s a submission object for each student representing their work and grade. Read-only. Nullable.' - operationId: education.user.assignment_ListSubmission - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationSubmissionCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationUser - summary: Create new navigation property to submissions for education - operationId: education.user.assignment_CreateSubmission - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}': - get: - tags: - - education.educationUser - summary: Get submissions from education - description: 'Once published, there''s a submission object for each student representing their work and grade. Read-only. Nullable.' - operationId: education.user.assignment_GetSubmission - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationUser - summary: Update the navigation property submissions in education - operationId: education.user.assignment_UpdateSubmission - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete navigation property submissions for education - operationId: education.user.assignment_DeleteSubmission - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.excuse': - post: - tags: - - education.educationUser - summary: Invoke action excuse - description: 'Excuse a submission. Excused submissions aren''t included in average grade calculations. Grading rubrics and feedback are deleted. Only teachers can perform this action. If the Prefer: include-unknown-enum-members request header is provided, the excused submission shows the excused status. Otherwise, the submission status retains the returned status. For more information about how to use this header, see the Examples section.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-excuse?view=graph-rest-1.0 - operationId: education.user.assignment.submission_excuse - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.reassign': - post: - tags: - - education.educationUser - summary: Invoke action reassign - description: 'Reassign the submission to the student with feedback for review. Only teachers can perform this action. Include the Prefer: include-unknown-enum-members header when you call this method; otherwise, a reassigned submission is treated as a returned submission. This means that the reassigned status is mapped to the returned status, and reassignedDateTime and reassignedBy properties are mapped to returnedDateTime and returnedBy respectively. If the header Prefer: include-unknown-enum-members is provided, a reassigned submission retains the reassigned status. For details, see the examples section.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-reassign?view=graph-rest-1.0 - operationId: education.user.assignment.submission_reassign - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.return': - post: - tags: - - education.educationUser - summary: Invoke action return - description: Make the grade and feedback associated with this submission available to the student. This action changes the status of the submission from 'submitted' to 'returned' and indicates that feedback is provided or grading is done. This action can only be done by the teacher. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-return?view=graph-rest-1.0 - operationId: education.user.assignment.submission_return - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.setUpResourcesFolder': - post: - tags: - - education.educationUser - summary: Invoke action setUpResourcesFolder - description: 'Trigger the creation of the SharePoint resource folder where all file-based resources (Word, Excel, and so on) should be uploaded for a given submission. Only teachers and students can perform this operation. Note that files must be located in this folder in order to be added as resources. Only a student in the class can determine what files to upload in a given submission-level resource folder. ' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-setupresourcesfolder?view=graph-rest-1.0 - operationId: education.user.assignment.submission_setUpResourcesFolder - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.submit': - post: - tags: - - education.educationUser - summary: Invoke action submit - description: 'Indicate that a student is done with the work and is ready to hand in the assignment. Only teachers, students, and applications with application permissions can perform this operation. This method changes the status of the submission from working to submitted. During the submit process, all the resources are copied to the submittedResources bucket. The teacher will be looking at the submitted resources list for grading. A teacher can also submit a student''s assignment on their behalf.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-submit?view=graph-rest-1.0 - operationId: education.user.assignment.submission_submit - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.unsubmit': - post: - tags: - - education.educationUser - summary: Invoke action unsubmit - description: 'Indicate that a student wants to work on the submission of the assignment after it was turned in. Only teachers, students, and applications with application permissions can perform this operation. This method changes the status of the submission from submitted to working. During the submit process, all the resources are copied from submittedResources to workingResources. The teacher will be looking at the working resources list for grading. A teacher can also unsubmit a student''s assignment on their behalf.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationsubmission-unsubmit?view=graph-rest-1.0 - operationId: education.user.assignment.submission_unsubmit - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmission' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/outcomes': - get: - tags: - - education.educationUser - summary: Get outcomes from education - operationId: education.user.assignment.submission_ListOutcome - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationOutcomeCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationUser - summary: Create new navigation property to outcomes for education - operationId: education.user.assignment.submission_CreateOutcome - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationOutcome' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationOutcome' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/outcomes/{educationOutcome-id}': - get: - tags: - - education.educationUser - summary: Get outcomes from education - operationId: education.user.assignment.submission_GetOutcome - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationOutcome-id - in: path - description: The unique identifier of educationOutcome - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationOutcome - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationOutcome' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationUser - summary: Update the navigation property outcomes in education - operationId: education.user.assignment.submission_UpdateOutcome - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationOutcome-id - in: path - description: The unique identifier of educationOutcome - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationOutcome - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationOutcome' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationOutcome' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete navigation property outcomes for education - operationId: education.user.assignment.submission_DeleteOutcome - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationOutcome-id - in: path - description: The unique identifier of educationOutcome - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationOutcome - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/outcomes/$count': - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.user.assignment.submission.outcome_GetCount - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/resources': - get: - tags: - - education.educationUser - summary: Get resources from education - operationId: education.user.assignment.submission_ListResource - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationSubmissionResourceCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationUser - summary: Create new navigation property to resources for education - operationId: education.user.assignment.submission_CreateResource - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/resources/{educationSubmissionResource-id}': - get: - tags: - - education.educationUser - summary: Get resources from education - operationId: education.user.assignment.submission_GetResource - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationSubmissionResource-id - in: path - description: The unique identifier of educationSubmissionResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmissionResource - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationUser - summary: Update the navigation property resources in education - operationId: education.user.assignment.submission_UpdateResource - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationSubmissionResource-id - in: path - description: The unique identifier of educationSubmissionResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmissionResource - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete navigation property resources for education - operationId: education.user.assignment.submission_DeleteResource - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationSubmissionResource-id - in: path - description: The unique identifier of educationSubmissionResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmissionResource - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/resources/$count': - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.user.assignment.submission.resource_GetCount - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/submittedResources': - get: - tags: - - education.educationUser - summary: Get submittedResources from education - operationId: education.user.assignment.submission_ListSubmittedResource - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationSubmissionResourceCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationUser - summary: Create new navigation property to submittedResources for education - operationId: education.user.assignment.submission_CreateSubmittedResource - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/submittedResources/{educationSubmissionResource-id}': - get: - tags: - - education.educationUser - summary: Get submittedResources from education - operationId: education.user.assignment.submission_GetSubmittedResource - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationSubmissionResource-id - in: path - description: The unique identifier of educationSubmissionResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmissionResource - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationUser - summary: Update the navigation property submittedResources in education - operationId: education.user.assignment.submission_UpdateSubmittedResource - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationSubmissionResource-id - in: path - description: The unique identifier of educationSubmissionResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmissionResource - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete navigation property submittedResources for education - operationId: education.user.assignment.submission_DeleteSubmittedResource - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - name: educationSubmissionResource-id - in: path - description: The unique identifier of educationSubmissionResource - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmissionResource - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/submittedResources/$count': - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.user.assignment.submission.submittedResource_GetCount - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - name: educationSubmission-id - in: path - description: The unique identifier of educationSubmission - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSubmission - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/$count': - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.user.assignment.submission_GetCount - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationAssignment-id - in: path - description: The unique identifier of educationAssignment - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationAssignment - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/users/{educationUser-id}/assignments/$count': - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.user.assignment_GetCount - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/users/{educationUser-id}/assignments/microsoft.graph.delta()': - get: - tags: - - education.educationUser - summary: Invoke function delta - description: Get a list of newly-created or updated assignments without reading the whole collection. A teacher or an application running with application permissions can see all assignment objects for the class. Students can only see assignments that are assigned to them. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationassignment-delta?view=graph-rest-1.0 - operationId: education.user.assignment_delta - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Success - content: - application/json: - schema: - title: Collection of educationAssignment - type: object - properties: - value: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.educationAssignment' - '@odata.nextLink': - type: string - nullable: true - '@odata.deltaLink': - type: string - nullable: true - additionalProperties: - type: object - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: function - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - '/education/users/{educationUser-id}/classes': - get: - tags: - - education.educationUser - summary: Get classes from education - description: Classes to which the user belongs. Nullable. - operationId: education.user_ListClass - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationClassCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/classes/{educationClass-id}': - get: - tags: - - education.educationUser - summary: Get classes from education - description: Classes to which the user belongs. Nullable. - operationId: education.user_GetClass - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationClass' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/classes/$count': - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.user.class_GetCount - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/users/{educationUser-id}/rubrics': - get: - tags: - - education.educationUser - summary: Get rubrics from education - description: 'When set, the grading rubric attached to the assignment.' - operationId: education.user_ListRubric - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationRubricCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - education.educationUser - summary: Create new navigation property to rubrics for education - operationId: education.user_CreateRubric - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRubric' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRubric' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/rubrics/{educationRubric-id}': - get: - tags: - - education.educationUser - summary: Get rubrics from education - description: 'When set, the grading rubric attached to the assignment.' - operationId: education.user_GetRubric - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationRubric-id - in: path - description: The unique identifier of educationRubric - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationRubric - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRubric' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - patch: - tags: - - education.educationUser - summary: Update the navigation property rubrics in education - operationId: education.user_UpdateRubric - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationRubric-id - in: path - description: The unique identifier of educationRubric - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationRubric - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRubric' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationRubric' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - education.educationUser - summary: Delete navigation property rubrics for education - operationId: education.user_DeleteRubric - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationRubric-id - in: path - description: The unique identifier of educationRubric - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationRubric - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/rubrics/$count': - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.user.rubric_GetCount - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/users/{educationUser-id}/schools': - get: - tags: - - education.educationUser - summary: Get schools from education - description: Schools to which the user belongs. Nullable. - operationId: education.user_ListSchool - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationSchoolCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/schools/{educationSchool-id}': - get: - tags: - - education.educationUser - summary: Get schools from education - description: Schools to which the user belongs. Nullable. - operationId: education.user_GetSchool - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationSchool-id - in: path - description: The unique identifier of educationSchool - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationSchool - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationSchool' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/schools/$count': - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.user.school_GetCount - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/users/{educationUser-id}/taughtClasses': - get: - tags: - - education.educationUser - summary: List taughtClasses - description: Get the educationClass resources owned by an educationUser. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationuser-list-taughtclasses?view=graph-rest-1.0 - operationId: education.user_ListTaughtClass - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.educationClassCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/taughtClasses/{educationClass-id}': - get: - tags: - - education.educationUser - summary: Get taughtClasses from education - description: Classes for which the user is a teacher. - operationId: education.user_GetTaughtClass - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: educationClass-id - in: path - description: The unique identifier of educationClass - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationClass - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.educationClass' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/taughtClasses/$count': - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.user.taughtClass_GetCount - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/education/users/{educationUser-id}/user': - get: - tags: - - education.educationUser - summary: Get user from education - description: The directory user that corresponds to this user. - operationId: education.user_GetUser - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.user' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/education/users/{educationUser-id}/user/mailboxSettings': - get: - tags: - - education.educationUser - summary: Get mailboxSettings property value - description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Returned only on $select.' - operationId: education.user_GetMailboxSetting - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Entity result. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.mailboxSettings' - default: - $ref: '#/components/responses/error' - patch: - tags: - - education.educationUser - summary: Update property mailboxSettings value. - operationId: education.user_UpdateMailboxSetting - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - requestBody: - description: New property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.mailboxSettings' - required: true - responses: - 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.mailboxSettings' - default: - $ref: '#/components/responses/error' - '/education/users/{educationUser-id}/user/serviceProvisioningErrors': - get: - tags: - - education.educationUser - summary: Get serviceProvisioningErrors property value - description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).' - operationId: education.user_ListServiceProvisioningError - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - '/education/users/{educationUser-id}/user/serviceProvisioningErrors/$count': - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.user.ServiceProvisioningError_GetCount - parameters: - - name: educationUser-id - in: path - description: The unique identifier of educationUser - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: educationUser - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - /education/users/$count: - get: - tags: - - education.educationUser - summary: Get the number of the resource - operationId: education.user_GetCount - parameters: - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - /education/users/microsoft.graph.delta(): - get: - tags: - - education.educationUser - summary: Invoke function delta - description: Get newly created or updated educationUser without having to perform a full read of the entire collection. See Use delta query for details. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/educationuser-delta?view=graph-rest-1.0 - operationId: education.user_delta - parameters: - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - description: Success - content: - application/json: - schema: - title: Collection of educationUser - type: object - properties: - value: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.educationUser' - '@odata.nextLink': - type: string - nullable: true - '@odata.deltaLink': - type: string - nullable: true - additionalProperties: - type: object - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: function - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore components: schemas: microsoft.graph.educationRoot: diff --git a/src/readme.graph.md b/src/readme.graph.md index 21337a60606..d492bd2b728 100644 --- a/src/readme.graph.md +++ b/src/readme.graph.md @@ -508,12 +508,14 @@ directive: ensureCall = ` if (BodyParameter != null) { + var _ = BodyParameter?.ToJsonString(); // force evaluation ${nameSpacePrefix}.ModelExtensions.ModelExtensions.EnsurePropertiesAreReady(BodyParameter, failOnExplicitNulls: false).GetAwaiter().GetResult(); }`; } else if ($.includes('_body')) { ensureCall = ` if (_body != null) { + var _ = _body?.ToJsonString(); // force evaluation ${nameSpacePrefix}.ModelExtensions.ModelExtensions.EnsurePropertiesAreReady(_body, failOnExplicitNulls: false).GetAwaiter().GetResult(); }`; } From 25d43cd561a044adf888549713fad5fd621015f4 Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Wed, 30 Apr 2025 15:41:00 +0300 Subject: [PATCH 09/24] updated directive --- src/readme.graph.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/src/readme.graph.md b/src/readme.graph.md index d492bd2b728..dd2ccf7730a 100644 --- a/src/readme.graph.md +++ b/src/readme.graph.md @@ -508,14 +508,20 @@ directive: ensureCall = ` if (BodyParameter != null) { - var _ = BodyParameter?.ToJsonString(); // force evaluation + foreach (var prop in BodyParameter.GetType().GetProperties()) + { + var val = prop.GetValue(BodyParameter); // force materialization + } ${nameSpacePrefix}.ModelExtensions.ModelExtensions.EnsurePropertiesAreReady(BodyParameter, failOnExplicitNulls: false).GetAwaiter().GetResult(); }`; } else if ($.includes('_body')) { ensureCall = ` if (_body != null) { - var _ = _body?.ToJsonString(); // force evaluation + foreach (var prop in _body.GetType().GetProperties()) + { + var val = prop.GetValue(_body); // force materialization + } ${nameSpacePrefix}.ModelExtensions.ModelExtensions.EnsurePropertiesAreReady(_body, failOnExplicitNulls: false).GetAwaiter().GetResult(); }`; } From 07f0a50a4f6226ca0b957202f1efff3cabb94e3e Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Wed, 30 Apr 2025 18:01:20 +0300 Subject: [PATCH 10/24] Fixed reflection error --- config/ModulesMapping.jsonc | 8 ++++---- tools/Custom/ModelExtensions.cs | 30 ++++++++++++++++++++++++------ 2 files changed, 28 insertions(+), 10 deletions(-) diff --git a/config/ModulesMapping.jsonc b/config/ModulesMapping.jsonc index fdbfe5ecd52..59ba2826b3a 100644 --- a/config/ModulesMapping.jsonc +++ b/config/ModulesMapping.jsonc @@ -1,5 +1,5 @@ { -// "Applications": "^applicationTemplates\\.|^applications\\.|^servicePrincipals\\.|^onPremisesPublishingProfiles\\.|^users.appRoleAssignment$|^groups.appRoleAssignment$", + "Applications": "^applicationTemplates\\.|^applications\\.|^servicePrincipals\\.|^onPremisesPublishingProfiles\\.|^users.appRoleAssignment$|^groups.appRoleAssignment$", // "Bookings": "^bookingBusinesses\\.|^bookingCurrencies\\.|^solutions.booking.*.Actions$|^solutions.bookingBusiness$|^solutions.bookingCurrency$|^solutions.virtualEventsRoot$|^solutions.booking.*.Functions$|^solutions.solutionsRoot$", // "BusinessScenario": "^solutions.businessScenario$|^solutions.BusinessScenario.*.Actions$|^solutions.BusinessScenario.*.Functions$", // "BackupRestore": "^solutions.backupRestoreRoot$|^solutions.backupRestore.*.Actions$|^solutions.backupRestore.*.Functions$", @@ -16,7 +16,7 @@ // "DeviceManagement.Enrollment": "^deviceManagement.(.*Enrollment.*|.*Autopilot.*|.*depOnboarding.*|importedDeviceIdentity|onPremisesConditionalAccessSettings|windowsFeatureUpdateProfile)$|^roleManagement.roleManagement$|^roleManagement.rbacApplicationMultiple$|^roleManagement.unifiedRbacApplication$", // "DeviceManagement.Functions": "^deviceManagement.*.Functions$", // "DirectoryObjects": "^directoryObjects\\.|^directory.publicKeyInfrastructureRoot$", - "Education": "^education\\.", + // "Education": "^education\\.", // "Files": "^drives\\.|^shares\\.|^users.drive$|^groups.drive$", // "Financials": "^financials\\.", // "Groups": "^groups.group$|^groups.directoryObject$|^groups.conversation$|^groups.endpoint$|^groups.extension$|^groups.groupLifecyclePolicy$|^groups.resourceSpecificPermissionGrant$|^groups.profilePhoto$|^groups.conversationThread$|^groupLifecyclePolicies\\.|^users.group$|^groups.directorySetting$|^groups.*.Actions$|^groups.*.Functions$|^groupSettings\\.|^groups.groupSetting$|^groupSettingTemplates\\.", @@ -28,7 +28,7 @@ // "ManagedTenants": "^tenantRelationships.managedTenant$", // "NetworkAccess": "^networkAccess\\.", // "Notes": "^users.onenote$|^groups.onenote$|^sites.onenote$", - "People": "^users.person$|^users.profile$|^users.officeGraphInsights$|^users.userAnalytics$", + // "People": "^users.person$|^users.profile$|^users.officeGraphInsights$|^users.userAnalytics$", // "PersonalContacts": "^users.contactFolder$|^users.contact$", // "Planner": "^planner\\.|^users.plannerUser$|^groups.plannerGroup$", // "Reports": "^reports\\.|^auditLogs\\.|^deviceManagement.deviceManagementReports$|^admin.adminReportSetting", @@ -37,7 +37,7 @@ // "Security": "^security\\.|^users.security$", // "Sites": "^sites.baseSitePage$|^sites.site$|^sites.itemAnalytics$|^sites.columnDefinition$|^sites.contentType$|^sites.drive$|^sites.list$|^sites.sitePage$|^sites.permission$|^sites.store$|^users.site$|^groups.site$|^sites.*.Functions$|^sites.*.Actions$|^sites.richLongRunningOperation$|^termStore.sets.ListChildren$|^admin.sharepoint$", // "Teams": "^teams\\.|^chats\\.|^users.chat$|^appCatalogs.teamsApp$|^users.userTeamwork$|^teamwork\\.|^users.team$|^groups.team$", -// "Users": "^users.user$|^users.directoryObject$|^users.licenseDetails$|^users.mailboxSettings|^users.notification$|^users.outlookUser$|^users.profilePhoto$|^users.userSettings$|^users.extension$|^users.oAuth2PermissionGrant$|^users.todo$|^users.itemInsights$|^users.servicePrincipal$", + "Users": "^users.user$|^users.directoryObject$|^users.licenseDetails$|^users.mailboxSettings|^users.notification$|^users.outlookUser$|^users.profilePhoto$|^users.userSettings$|^users.extension$|^users.oAuth2PermissionGrant$|^users.todo$|^users.itemInsights$|^users.servicePrincipal$", // "Users.Actions": "^users.*.Actions$", // "Users.Functions": "^users.*.Functions$", // "WindowsUpdates": "^admin.adminWindows$" diff --git a/tools/Custom/ModelExtensions.cs b/tools/Custom/ModelExtensions.cs index 1cf972355fa..76166d2e43b 100644 --- a/tools/Custom/ModelExtensions.cs +++ b/tools/Custom/ModelExtensions.cs @@ -60,17 +60,35 @@ public static async Task EnsurePropertiesAreReady( private static bool IsUnready(object model, PropertyInfo prop, MethodInfo isPropertySetMethod, bool failOnExplicitNulls) { - bool isSet = (bool)isPropertySetMethod.Invoke(model, new object[] { prop.Name }); - if (!isSet) return false; // not marked as set, skip + try + { + // Ensure method matches expected signature + var parameters = isPropertySetMethod.GetParameters(); + if (parameters.Length != 1 || parameters[0].ParameterType != typeof(string)) + { + Console.WriteLine($"WARNING: IsPropertySet signature mismatch for type {model.GetType().Name}"); + return false; + } + + bool isSet = (bool)isPropertySetMethod.Invoke(model, new object[] { prop.Name }); + if (!isSet) return false; - object value = prop.GetValue(model); + object value = prop.GetValue(model); + Console.WriteLine($"DEBUG: {prop.Name} = {value}, IsSet: {isSet}"); - if (value == null) - return failOnExplicitNulls; // null is OK in relaxed mode, fail in strict + if (value == null) + return failOnExplicitNulls; - return IsDefault(value); + return IsDefault(value); + } + catch (Exception ex) + { + Console.WriteLine($"ERROR: Failed to check IsPropertySet for {prop.Name} — {ex.Message}"); + return false; + } } + private static bool IsDefault(object value) { Type type = value.GetType(); From 219a288139b5b199ed1f37166f449180c7a70c9f Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Wed, 30 Apr 2025 22:37:41 +0300 Subject: [PATCH 11/24] updates --- config/ModuleMetadata.json | 6 +++--- tools/Custom/ModelExtensions.cs | 32 +++++++------------------------- 2 files changed, 10 insertions(+), 28 deletions(-) diff --git a/config/ModuleMetadata.json b/config/ModuleMetadata.json index 083aa159dc7..169f91bd322 100644 --- a/config/ModuleMetadata.json +++ b/config/ModuleMetadata.json @@ -27,15 +27,15 @@ "versions": { "authentication": { "prerelease": "", - "version": "2.27.3" + "version": "2.27.4" }, "beta": { "prerelease": "", - "version": "2.27.3" + "version": "2.27.4" }, "v1.0": { "prerelease": "", - "version": "2.27.3" + "version": "2.27.4" } } } diff --git a/tools/Custom/ModelExtensions.cs b/tools/Custom/ModelExtensions.cs index 76166d2e43b..031b8c7b2a4 100644 --- a/tools/Custom/ModelExtensions.cs +++ b/tools/Custom/ModelExtensions.cs @@ -60,35 +60,17 @@ public static async Task EnsurePropertiesAreReady( private static bool IsUnready(object model, PropertyInfo prop, MethodInfo isPropertySetMethod, bool failOnExplicitNulls) { - try - { - // Ensure method matches expected signature - var parameters = isPropertySetMethod.GetParameters(); - if (parameters.Length != 1 || parameters[0].ParameterType != typeof(string)) - { - Console.WriteLine($"WARNING: IsPropertySet signature mismatch for type {model.GetType().Name}"); - return false; - } - - bool isSet = (bool)isPropertySetMethod.Invoke(model, new object[] { prop.Name }); - if (!isSet) return false; + bool isSet = (bool)isPropertySetMethod.Invoke(model, new object[] { prop.Name }); + if (!isSet) return false; // not marked as set, skip - object value = prop.GetValue(model); - Console.WriteLine($"DEBUG: {prop.Name} = {value}, IsSet: {isSet}"); + object value = prop.GetValue(model); + + if (value == null) + return failOnExplicitNulls; // null is OK in relaxed mode, fail in strict - if (value == null) - return failOnExplicitNulls; - - return IsDefault(value); - } - catch (Exception ex) - { - Console.WriteLine($"ERROR: Failed to check IsPropertySet for {prop.Name} — {ex.Message}"); - return false; - } + return IsDefault(value); } - private static bool IsDefault(object value) { Type type = value.GetType(); From 9f71f3245d2500c5873bce8d4602ab7cd0a349c7 Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Thu, 1 May 2025 20:26:32 +0300 Subject: [PATCH 12/24] rolled back --- tools/Custom/ModelExtensions.cs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tools/Custom/ModelExtensions.cs b/tools/Custom/ModelExtensions.cs index 031b8c7b2a4..1cf972355fa 100644 --- a/tools/Custom/ModelExtensions.cs +++ b/tools/Custom/ModelExtensions.cs @@ -64,7 +64,7 @@ private static bool IsUnready(object model, PropertyInfo prop, MethodInfo isProp if (!isSet) return false; // not marked as set, skip object value = prop.GetValue(model); - + if (value == null) return failOnExplicitNulls; // null is OK in relaxed mode, fail in strict From 315ea129247087fd361f74aa7dea6160898c7b1c Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Wed, 7 May 2025 02:37:13 +0300 Subject: [PATCH 13/24] Update Model extensions class --- config/ModuleMetadata.json | 6 +- config/ModulesMapping.jsonc | 4 +- src/readme.graph.md | 71 +++++++++++-------- tools/Custom/ModelExtensions.cs | 118 +++++++++++++++++++------------- 4 files changed, 120 insertions(+), 79 deletions(-) diff --git a/config/ModuleMetadata.json b/config/ModuleMetadata.json index 169f91bd322..0de44d167bf 100644 --- a/config/ModuleMetadata.json +++ b/config/ModuleMetadata.json @@ -27,15 +27,15 @@ "versions": { "authentication": { "prerelease": "", - "version": "2.27.4" + "version": "2.27.5" }, "beta": { "prerelease": "", - "version": "2.27.4" + "version": "2.27.5" }, "v1.0": { "prerelease": "", - "version": "2.27.4" + "version": "2.27.5" } } } diff --git a/config/ModulesMapping.jsonc b/config/ModulesMapping.jsonc index 59ba2826b3a..5cac3b20d9f 100644 --- a/config/ModulesMapping.jsonc +++ b/config/ModulesMapping.jsonc @@ -1,5 +1,5 @@ { - "Applications": "^applicationTemplates\\.|^applications\\.|^servicePrincipals\\.|^onPremisesPublishingProfiles\\.|^users.appRoleAssignment$|^groups.appRoleAssignment$", +// "Applications": "^applicationTemplates\\.|^applications\\.|^servicePrincipals\\.|^onPremisesPublishingProfiles\\.|^users.appRoleAssignment$|^groups.appRoleAssignment$", // "Bookings": "^bookingBusinesses\\.|^bookingCurrencies\\.|^solutions.booking.*.Actions$|^solutions.bookingBusiness$|^solutions.bookingCurrency$|^solutions.virtualEventsRoot$|^solutions.booking.*.Functions$|^solutions.solutionsRoot$", // "BusinessScenario": "^solutions.businessScenario$|^solutions.BusinessScenario.*.Actions$|^solutions.BusinessScenario.*.Functions$", // "BackupRestore": "^solutions.backupRestoreRoot$|^solutions.backupRestore.*.Actions$|^solutions.backupRestore.*.Functions$", @@ -19,7 +19,7 @@ // "Education": "^education\\.", // "Files": "^drives\\.|^shares\\.|^users.drive$|^groups.drive$", // "Financials": "^financials\\.", -// "Groups": "^groups.group$|^groups.directoryObject$|^groups.conversation$|^groups.endpoint$|^groups.extension$|^groups.groupLifecyclePolicy$|^groups.resourceSpecificPermissionGrant$|^groups.profilePhoto$|^groups.conversationThread$|^groupLifecyclePolicies\\.|^users.group$|^groups.directorySetting$|^groups.*.Actions$|^groups.*.Functions$|^groupSettings\\.|^groups.groupSetting$|^groupSettingTemplates\\.", + "Groups": "^groups.group$|^groups.directoryObject$|^groups.conversation$|^groups.endpoint$|^groups.extension$|^groups.groupLifecyclePolicy$|^groups.resourceSpecificPermissionGrant$|^groups.profilePhoto$|^groups.conversationThread$|^groupLifecyclePolicies\\.|^users.group$|^groups.directorySetting$|^groups.*.Actions$|^groups.*.Functions$|^groupSettings\\.|^groups.groupSetting$|^groupSettingTemplates\\.", // "Identity.DirectoryManagement": "^administrativeUnits\\.|^contacts\\.|^devices\\.|^domains\\.|^directoryRoles\\.|^directoryRoleTemplates\\.|^directorySettingTemplates\\.|^settings\\.|^subscribedSkus\\.|^contracts\\.|^directory\\.|^users.scopedRoleMembership$|^organization.organization$|^organization.organizationalBranding$|^organization.organizationSettings$|^organization.*.Actions$|^organization.extension$|^tenantRelationships.*.Actions$|^tenantRelationships.*.Functions$|admin.peopleAdminSettings$|^organization\\.partnerInformation$", // "Identity.Governance": "^accessReviews\\.|^businessFlowTemplates\\.|^programs\\.|^programControls\\.|^programControlTypes\\.|^privilegedRoles\\.|^privilegedRoleAssignments\\.|^privilegedRoleAssignmentRequests\\.|^privilegedApproval\\.|^privilegedOperationEvents\\.|^privilegedAccess\\.|^agreements\\.|^users.agreementAcceptance$|^identityGovernance\\.|^roleManagement.rbacApplication$|^roleManagement.*.Functions$|roleManagement.*.Actions$", // "Identity.SignIns": "^organization.certificateBasedAuthConfiguration$|^invitations\\.|^identityProviders\\.|^oauth2PermissionGrants\\.|^identityProtection\\.|^dataPolicyOperations\\.|^identity\\.|^trustFramework\\.|^informationProtection\\.|^policies\\.|^users.authentication$|^users.informationProtection$|^tenantRelationships.multiTenantOrganization$|^policies.deviceRegistrationPolicy$|^policies.deviceRegistrationPolicy$", diff --git a/src/readme.graph.md b/src/readme.graph.md index dd2ccf7730a..03924c0df3d 100644 --- a/src/readme.graph.md +++ b/src/readme.graph.md @@ -503,38 +503,55 @@ directive: nameSpacePrefix = prefixMatch[1]; } - let ensureCall = ''; - if ($.includes('BodyParameter')) { - ensureCall = ` - if (BodyParameter != null) - { - foreach (var prop in BodyParameter.GetType().GetProperties()) + $ = $.replace( + /await this\.Client\.(\w+)\(\s*Headers\s*,\s*(BodyParameter|_body)\b([^;]+);/g, + (match, methodName, bodyParam, rest) => { + let ensureCall = ''; + + if (bodyParam === 'BodyParameter') { + ensureCall = ` + if (BodyParameter != null) { - var val = prop.GetValue(BodyParameter); // force materialization - } - ${nameSpacePrefix}.ModelExtensions.ModelExtensions.EnsurePropertiesAreReady(BodyParameter, failOnExplicitNulls: false).GetAwaiter().GetResult(); - }`; - } else if ($.includes('_body')) { - ensureCall = ` - if (_body != null) - { - foreach (var prop in _body.GetType().GetProperties()) + foreach (var prop in BodyParameter.GetType().GetProperties()) + { + // Skip indexer properties + if (prop.GetIndexParameters().Length == 0) + { + try + { + var val = prop.GetValue(BodyParameter); // force materialization + } + catch + {} + } + } + await ${nameSpacePrefix}.ModelExtensions.ModelExtensions.EnsurePropertiesAreReady(BodyParameter, failOnExplicitNulls: false); + }`; + } else if (bodyParam === '_body') { + ensureCall = ` + if (_body != null) { - var val = prop.GetValue(_body); // force materialization - } - ${nameSpacePrefix}.ModelExtensions.ModelExtensions.EnsurePropertiesAreReady(_body, failOnExplicitNulls: false).GetAwaiter().GetResult(); - }`; - } + foreach (var prop in _body.GetType().GetProperties()) + { + // Skip indexer properties + if (prop.GetIndexParameters().Length == 0) + { + try + { + var val = prop.GetValue(_body); // force materialization + } + catch + {} + } + } + await ${nameSpacePrefix}.ModelExtensions.ModelExtensions.EnsurePropertiesAreReady(_body, failOnExplicitNulls: false); + }`; + } - $ = $.replace( - /protected override void BeginProcessing\(\)\s*\{\s*([\s\S]*?)(if\s*\(Break\))/g, - `protected override void BeginProcessing() { - Module.Instance.SetProxyConfiguration(Proxy, ProxyCredential, ProxyUseDefaultCredentials); - ${ensureCall} - $1$2` + return `${ensureCall}\nawait this.Client.${methodName}(Headers, ${bodyParam}${rest};`; + } ); - return $; } diff --git a/tools/Custom/ModelExtensions.cs b/tools/Custom/ModelExtensions.cs index 1cf972355fa..17898921967 100644 --- a/tools/Custom/ModelExtensions.cs +++ b/tools/Custom/ModelExtensions.cs @@ -1,6 +1,7 @@ using System; using System.Linq; using System.Reflection; +using System.Collections; using System.Threading.Tasks; using NamespacePrefixPlaceholder.PowerShell.Runtime; @@ -8,75 +9,98 @@ namespace NamespacePrefixPlaceholder.PowerShell.ModelExtensions { public static class ModelExtensions { - /// - /// Ensures that all properties marked as set on the model have meaningful values. - /// - /// The model object (must implement IsPropertySet(string)). - /// If true, properties explicitly set to null will be considered invalid (strict mode). - /// Number of retries for late-bound properties. - /// Delay (ms) between retries. public static async Task EnsurePropertiesAreReady( this object model, bool failOnExplicitNulls = false, int retries = 3, - int delayMs = 1000) + int delayMs = 1000, + bool debug = false) { if (model == null) throw new ArgumentNullException(nameof(model)); - // Ensure the model supports IsPropertySet(string) - var isPropertySetMethod = model.GetType().GetMethod("IsPropertySet", BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic); - if (isPropertySetMethod == null) - throw new InvalidOperationException($"{model.GetType().Name} does not implement IsPropertySet(string)"); + var modelType = model.GetType(); + var isSetMethod = modelType.GetMethod("IsPropertySet", BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic); - var props = model.GetType().GetProperties(BindingFlags.Instance | BindingFlags.Public); + if (isSetMethod == null) + return; // Skip if model doesn't support property tracking - for (int attempt = 0; attempt <= retries; attempt++) + for (int attempt = 0; attempt < retries; attempt++) { - var unready = props - .Where(p => IsUnready(model, p, isPropertySetMethod, failOnExplicitNulls)) - .ToList(); + bool allReady = true; + foreach (var prop in modelType.GetProperties(BindingFlags.Public | BindingFlags.Instance)) + { + if (!prop.CanRead) continue; - if (!unready.Any()) - return; // Ready! + bool isSet = (bool)isSetMethod.Invoke(model, new object[] { prop.Name }); + object value = null; - if (attempt < retries) - await Task.Delay(delayMs); - } + try + { + value = prop.GetValue(model); + } + catch { /* Handle properties that might throw on get */ } - // Final check before throwing - var stillUnready = props - .Where(p => IsUnready(model, p, isPropertySetMethod, failOnExplicitNulls)) - .Select(p => p.Name) - .ToList(); + if (debug) + Console.WriteLine($"DEBUG: Property={prop.Name}, IsSet={isSet}, Value={(value == null ? "null" : value.ToString())}"); - if (stillUnready.Any()) - { - throw new InvalidOperationException( - $"Model '{model.GetType().Name}' has properties marked as set but not initialized properly: {string.Join(", ", stillUnready)}" - ); - } - } + if (!isSet) + continue; // skip unset properties - private static bool IsUnready(object model, PropertyInfo prop, MethodInfo isPropertySetMethod, bool failOnExplicitNulls) - { - bool isSet = (bool)isPropertySetMethod.Invoke(model, new object[] { prop.Name }); - if (!isSet) return false; // not marked as set, skip + if (value == null && failOnExplicitNulls) + { + allReady = false; + break; + } + + if (value != null && IsDefault(value) && failOnExplicitNulls) + { + allReady = false; + break; + } - object value = prop.GetValue(model); + // Recursively check nested models + if (value != null && !IsSimple(value)) + { + if (value is IEnumerable enumerable && !(value is string)) + { + foreach (var item in enumerable) + await EnsurePropertiesAreReady(item, failOnExplicitNulls, 1, 0, debug); + } + else + { + await EnsurePropertiesAreReady(value, failOnExplicitNulls, 1, 0, debug); + } + } + } - if (value == null) - return failOnExplicitNulls; // null is OK in relaxed mode, fail in strict + if (allReady) + return; - return IsDefault(value); + if (attempt < retries - 1) + await Task.Delay(delayMs); + } + + throw new InvalidOperationException("One or more required properties were not ready after retries."); + } + + private static bool IsSimple(object obj) + { + var type = obj.GetType(); + return type.IsPrimitive + || type.IsEnum + || type == typeof(string) + || type == typeof(DateTime) + || type == typeof(decimal) + || type == typeof(Guid) + || type == typeof(TimeSpan); } - private static bool IsDefault(object value) + private static bool IsDefault(object obj) { - Type type = value.GetType(); - if (!type.IsValueType) return false; - object defaultValue = Activator.CreateInstance(type); - return value.Equals(defaultValue); + var type = obj.GetType(); + object defaultValue = type.IsValueType ? Activator.CreateInstance(type) : null; + return Equals(obj, defaultValue); } } } From 112d4cb105359ebdf4a59bc9688486d29ed24236 Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Wed, 7 May 2025 12:16:28 +0300 Subject: [PATCH 14/24] Changed property tracker logic --- config/ModuleMetadata.json | 8 ++++---- tools/Custom/PropertyTracker.cs | 8 ++++++-- 2 files changed, 10 insertions(+), 6 deletions(-) diff --git a/config/ModuleMetadata.json b/config/ModuleMetadata.json index 295b091194e..45049ef859f 100644 --- a/config/ModuleMetadata.json +++ b/config/ModuleMetadata.json @@ -27,15 +27,15 @@ "versions": { "authentication": { "prerelease": "", - "version": "2.27.5" + "version": "2.27.6" }, "beta": { "prerelease": "", - "version": "2.27.5" + "version": "2.27.6" }, "v1.0": { "prerelease": "", - "version": "2.27.5" - }, + "version": "2.27.6" + } } } diff --git a/tools/Custom/PropertyTracker.cs b/tools/Custom/PropertyTracker.cs index 1d8dde56db3..0bc1312dd6c 100644 --- a/tools/Custom/PropertyTracker.cs +++ b/tools/Custom/PropertyTracker.cs @@ -10,7 +10,11 @@ public class PropertyTracker public void TrackProperty(string propertyName) { - _trackedProperties.Add(propertyName); // ✅ Track properties that are set + if (!string.IsNullOrWhiteSpace(propertyName)) + { + propertyName = char.ToLower(propertyName[0]) + propertyName.Substring(1); // ✅ force camelCase + _trackedProperties.Add(propertyName); // ✅ Track properties that are set + } } public bool IsPropertySet(string propertyName) @@ -18,7 +22,7 @@ public bool IsPropertySet(string propertyName) // Ensure that the first character of the property name is UpperCase if (propertyName.Length > 0) { - propertyName = char.ToUpper(propertyName[0]) + propertyName.Substring(1); + propertyName = char.ToLower(propertyName[0]) + propertyName.Substring(1); // ✅ match camelCase } return _trackedProperties.Contains(propertyName); } From 0cf2c80e3f77f24ce359c1f4f302862e85a79ef3 Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Wed, 7 May 2025 15:19:19 +0300 Subject: [PATCH 15/24] Updated directive to extend check to the api class --- config/ModuleMetadata.json | 6 +++--- src/readme.graph.md | 9 +++++++++ 2 files changed, 12 insertions(+), 3 deletions(-) diff --git a/config/ModuleMetadata.json b/config/ModuleMetadata.json index 45049ef859f..996e1a1e9be 100644 --- a/config/ModuleMetadata.json +++ b/config/ModuleMetadata.json @@ -27,15 +27,15 @@ "versions": { "authentication": { "prerelease": "", - "version": "2.27.6" + "version": "2.27.7" }, "beta": { "prerelease": "", - "version": "2.27.6" + "version": "2.27.7" }, "v1.0": { "prerelease": "", - "version": "2.27.6" + "version": "2.27.7" } } } diff --git a/src/readme.graph.md b/src/readme.graph.md index 03924c0df3d..5d9a9f9171d 100644 --- a/src/readme.graph.md +++ b/src/readme.graph.md @@ -753,6 +753,15 @@ directive: $ = $.replace(/request\.Content\s*=\s*new\s+global::System\.Net\.Http\.StringContent\(\s*null\s*!=\s*body\s*\?\s*new\s+Microsoft\.Graph\.Beta\.PowerShell\.Runtime\.Json\.XNodeArray\(.*?\)\s*:\s*null,\s*global::System\.Text\.Encoding\.UTF8\);/g,'request.Content = new global::System.Net.Http.StringContent(cleanedBody, global::System.Text.Encoding.UTF8);'); $ = $.replace(/cleanedBody = Microsoft.*.ReplaceAndRemoveSlashes\(cleanedBody\);/gm,'') + + let nameSpacePrefixRegex = /(Microsoft(?:\.\w+)*?\.PowerShell)/gm + let nameSpacePrefix = 'Microsoft.Graph.PowerShell'; + if($.match(nameSpacePrefixRegex)){ + let prefixMatch = nameSpacePrefixRegex.exec($); + nameSpacePrefix = prefixMatch[1]; + } + $ = $.replace(/cleanedBody\s*=\s*body\.ToJson\(null\)\.ToString\(\);/g,await ${nameSpacePrefix}.ModelExtensions.EnsurePropertiesAreReady(body, failOnExplicitNulls: false);\n cleanedBody = body.ToJson(null).ToString();` + ); return $ } From c5d95d63a94dd111ea79eb90f78b2f2c8d04a849 Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Wed, 7 May 2025 15:39:55 +0300 Subject: [PATCH 16/24] Removed syntax error --- src/readme.graph.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/readme.graph.md b/src/readme.graph.md index 5d9a9f9171d..7182134fd5c 100644 --- a/src/readme.graph.md +++ b/src/readme.graph.md @@ -760,7 +760,7 @@ directive: let prefixMatch = nameSpacePrefixRegex.exec($); nameSpacePrefix = prefixMatch[1]; } - $ = $.replace(/cleanedBody\s*=\s*body\.ToJson\(null\)\.ToString\(\);/g,await ${nameSpacePrefix}.ModelExtensions.EnsurePropertiesAreReady(body, failOnExplicitNulls: false);\n cleanedBody = body.ToJson(null).ToString();` + $ = $.replace(/cleanedBody\s*=\s*body\.ToJson\(null\)\.ToString\(\);/g,'await '+nameSpacePrefix+'.ModelExtensions.EnsurePropertiesAreReady(body, failOnExplicitNulls: false);\n cleanedBody = body.ToJson(null).ToString();' ); return $ } From 7abc9f9a75eb237a574745afc5e2f11ac90ff85f Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Wed, 7 May 2025 16:05:45 +0300 Subject: [PATCH 17/24] Updated directive --- src/readme.graph.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/readme.graph.md b/src/readme.graph.md index 7182134fd5c..87b37c2d6b6 100644 --- a/src/readme.graph.md +++ b/src/readme.graph.md @@ -760,7 +760,7 @@ directive: let prefixMatch = nameSpacePrefixRegex.exec($); nameSpacePrefix = prefixMatch[1]; } - $ = $.replace(/cleanedBody\s*=\s*body\.ToJson\(null\)\.ToString\(\);/g,'await '+nameSpacePrefix+'.ModelExtensions.EnsurePropertiesAreReady(body, failOnExplicitNulls: false);\n cleanedBody = body.ToJson(null).ToString();' + $ = $.replace(/cleanedBody\s*=\s*body\.ToJson\(null\)\.ToString\(\);/g,'await '+nameSpacePrefix+'.ModelExtensions.ModelExtensions.EnsurePropertiesAreReady(body, failOnExplicitNulls: false);\n cleanedBody = body.ToJson(null).ToString();' ); return $ } From 1dd63e65cc99c0723da0fd780ecf2a36ba2f4ba2 Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Wed, 7 May 2025 21:42:08 +0300 Subject: [PATCH 18/24] Updated regex to comment out Json Extensions --- config/ModuleMetadata.json | 6 +++--- src/readme.graph.md | 2 ++ 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/config/ModuleMetadata.json b/config/ModuleMetadata.json index 996e1a1e9be..9ac44dfe86a 100644 --- a/config/ModuleMetadata.json +++ b/config/ModuleMetadata.json @@ -27,15 +27,15 @@ "versions": { "authentication": { "prerelease": "", - "version": "2.27.7" + "version": "2.27.8" }, "beta": { "prerelease": "", - "version": "2.27.7" + "version": "2.27.8" }, "v1.0": { "prerelease": "", - "version": "2.27.7" + "version": "2.27.8" } } } diff --git a/src/readme.graph.md b/src/readme.graph.md index 87b37c2d6b6..3cad503f231 100644 --- a/src/readme.graph.md +++ b/src/readme.graph.md @@ -761,6 +761,8 @@ directive: nameSpacePrefix = prefixMatch[1]; } $ = $.replace(/cleanedBody\s*=\s*body\.ToJson\(null\)\.ToString\(\);/g,'await '+nameSpacePrefix+'.ModelExtensions.ModelExtensions.EnsurePropertiesAreReady(body, failOnExplicitNulls: false);\n cleanedBody = body.ToJson(null).ToString();' + ); + $ = $.replace(/(^\s*)cleanedBody\s*=\s*Microsoft\.Graph\.(?:Beta\.)?PowerShell\.JsonUtilities\.JsonExtensions\.RemoveDefaultNullProperties\s*\(\s*jsonObject\s*\)\s*;/gm,'$1// cleanedBody = Microsoft.Graph.$2PowerShell.JsonUtilities.JsonExtensions.RemoveDefaultNullProperties(jsonObject);' ); return $ } From fbe6fe547d450cb630089b3374d281b514edd92e Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Thu, 8 May 2025 00:11:32 +0300 Subject: [PATCH 19/24] Removed property tracker implementation --- config/ModuleMetadata.json | 6 +- config/ModulesMapping.jsonc | 2 +- src/readme.graph.md | 107 ------------------------------------ 3 files changed, 4 insertions(+), 111 deletions(-) diff --git a/config/ModuleMetadata.json b/config/ModuleMetadata.json index 9ac44dfe86a..0c910b6b1d6 100644 --- a/config/ModuleMetadata.json +++ b/config/ModuleMetadata.json @@ -27,15 +27,15 @@ "versions": { "authentication": { "prerelease": "", - "version": "2.27.8" + "version": "2.28.2" }, "beta": { "prerelease": "", - "version": "2.27.8" + "version": "2.28.2" }, "v1.0": { "prerelease": "", - "version": "2.27.8" + "version": "2.28.2" } } } diff --git a/config/ModulesMapping.jsonc b/config/ModulesMapping.jsonc index 5cac3b20d9f..ded0051a0f6 100644 --- a/config/ModulesMapping.jsonc +++ b/config/ModulesMapping.jsonc @@ -34,7 +34,7 @@ // "Reports": "^reports\\.|^auditLogs\\.|^deviceManagement.deviceManagementReports$|^admin.adminReportSetting", // "SchemaExtensions": "^schemaExtensions\\.", // "Search": "^search\\.|^external\\.", -// "Security": "^security\\.|^users.security$", + "Security": "^security\\.|^users.security$", // "Sites": "^sites.baseSitePage$|^sites.site$|^sites.itemAnalytics$|^sites.columnDefinition$|^sites.contentType$|^sites.drive$|^sites.list$|^sites.sitePage$|^sites.permission$|^sites.store$|^users.site$|^groups.site$|^sites.*.Functions$|^sites.*.Actions$|^sites.richLongRunningOperation$|^termStore.sets.ListChildren$|^admin.sharepoint$", // "Teams": "^teams\\.|^chats\\.|^users.chat$|^appCatalogs.teamsApp$|^users.userTeamwork$|^teamwork\\.|^users.team$|^groups.team$", "Users": "^users.user$|^users.directoryObject$|^users.licenseDetails$|^users.mailboxSettings|^users.notification$|^users.outlookUser$|^users.profilePhoto$|^users.userSettings$|^users.extension$|^users.oAuth2PermissionGrant$|^users.todo$|^users.itemInsights$|^users.servicePrincipal$", diff --git a/src/readme.graph.md b/src/readme.graph.md index 3cad503f231..d7d1b21ddcd 100644 --- a/src/readme.graph.md +++ b/src/readme.graph.md @@ -334,25 +334,6 @@ directive: let dateTimeToJsonRegex = /(\.Json\.JsonString\()(.*)\?(\.ToString\(@"yyyy'-'MM'-'dd'T'HH':'mm':'ss\.fffffffK")/gm $ = $.replace(dateTimeToJsonRegex, '$1System.DateTime.SpecifyKind($2.Value.ToUniversalTime(), System.DateTimeKind.Utc)$3'); - //The following regex below adds a property tracker to ensure that users can also pass $Null as an alternative to the current "null" string which gets inferred to null. - - const regexP = /AddIf\(\s*null\s*!=\s*\(\(\(object\)this\._(\w+).*?(\(Microsoft.*.PowerShell\.Runtime\.Json\.JsonNode\)).*?"(\w+)".*?container\.Add\s*\);/gm - $ = $.replace(regexP, (match, p1, p2, p3) => { - let capitalizedP1 = p1.charAt(0).toUpperCase() + p1.slice(1); // Capitalize first letter - return `if(this.IsPropertySet("${p1}"))\n\t\t{\n\t\t\tvar propertyInfo = this.GetType().GetProperty("${capitalizedP1}");\n\t\t\tif (propertyInfo != null)\n\t\t\t{\n\t\t\tSystem.Type propertyType = propertyInfo.PropertyType;\n\t\t\t\t\tAddIf(${p2}PropertyTracker.ConvertToJsonNode(propertyType, this._${p1}),"${p1}",container.Add);\n\t\t\t}\n\t\t}`; - }); - - $ = $.replace(/if\s*\(\s*null\s*!=\s*this\._(\w+)\s*\)/gm, 'if(this.IsPropertySet("$1"))') - - let nameSpacePrefixRegex = /(Microsoft(?:\.\w+)*?\.PowerShell)/gm - let nameSpacePrefix = 'Microsoft.Graph.PowerShell'; - if($.match(nameSpacePrefixRegex)){ - let prefixMatch = nameSpacePrefixRegex.exec($); - nameSpacePrefix = prefixMatch[1]; - } - $ = $.replace(/container\.Add\("(\w+)",\s*(__\w+)\);/gm, 'var nullFlag = ('+nameSpacePrefix+'.Runtime.Json.JsonNode)new '+nameSpacePrefix+'.Runtime.Json.JsonString("nullarray");\n\t\tif($2.Count == 0)\n\t\t{\n\t\t\t$2.Add(nullFlag);\n\t\t}\n\t\tcontainer.Add("$1", $2);'); - - $ =$.replace(/AddIf\(\s+null\s+!=\s+(this\._\w+)\s+\?\s+\((Microsoft\.Graph\..*?)\)\s+this\._(\w+)\.ToJson\(null,serializationMode\)\s+:\s+null,\s+"\w+"\s+,container.Add\s+\);/gm, 'if (this.IsPropertySet("$3")) \n{\n if ($1 != null)\n{\n container.Add("$3", ($2)$1.ToJson(null, serializationMode)); \n}\nelse\n{\n container.Add("$3", "null"); \n}\n}'); return $; } @@ -419,28 +400,6 @@ directive: if($.match(additionalPropertiesRegex)) { $ = $.replace(additionalPropertiesRegex, '$1$2 new $3'); } - //The following regex below adds a property tracker to ensure that users can also pass $Null as an alternative to the current "null" string which gets inferred to null. - $ = $.replace(/\bpublic\s+(\w+\??)\s+(\w+)\s*{\s*get\s*=>\s*this\.(\w+);\s*set\s*=>\s*this\.\3\s*=\s*value;\s*}/gmi,'public $1 $2\n\t{\n\t\tget=>this.$3;\n\t\tset\n\t\t{\n\t\t\tthis.$3=SanitizeValue<$1>(value);\n\t\t\tTrackProperty(nameof($2));\n\t\t}\n\t}') - - $ = $.replace(/\bpublic\s+(\w+\[\])\s+(\w+)\s*{\s*get\s*=>\s*this\.(\w+);\s*set\s*=>\s*this\.\3\s*=\s*value;\s*}/gm,'public $1 $2\n\t{\n\t\tget=>this.$3;\n\t\tset\n\t\t{\n\t\t\tthis.$3=value;\n\t\t\tTrackProperty(nameof($2));\n\t\t}\n\t}') - - $ = $.replace(/\bpublic\s+(Microsoft\.Graph\.[\w.]+\[\])\s+(\w+)\s*{\s*get\s*=>\s*this\.(\w+);\s*set\s*=>\s*this\.\3\s*=\s*value;\s*}/gm,'public $1 $2\n\t{\n\t\tget=>this.$3;\n\t\tset\n\t\t{\n\t\t\tthis.$3=value;\n\t\t\tTrackProperty(nameof($2));\n\t\t}\n\t}') - - const match = $documentPath.match(/generated%2Fapi%2FModels%2F([\w]*[\w\d]*)\.cs/gm); - if (match) { - let fileName = match[0]; - fileName = fileName.replace('generated%2Fapi%2FModels%2F','') - fileName = fileName.replace('.cs','') - const interfaceName = 'I'+fileName - $ = $.replace('interface '+interfaceName+' :', 'interface '+interfaceName+' : IPropertyTracker,') - const className = fileName - const regexP = new RegExp(`public\\s+partial\\s+class\\s+${className}\\s*:\\s*[\\s\\S]*?{`, "gm"); - var matches = regexP.exec($); - let originalMatch = matches[0]; - $ = $.replace(regexP, originalMatch+'\n\t\tprivate readonly PropertyTracker _propertyTracker = new PropertyTracker();\n\t\tpublic void TrackProperty(string propertyName) => _propertyTracker.TrackProperty(propertyName);\n\t\tpublic bool IsPropertySet(string propertyName) =>_propertyTracker.IsPropertySet(propertyName);\n\t\tpublic T SanitizeValue(object value) => PropertyTracker.SanitizeValue(value);'); - } - - $ = $.replace(/public\s+(Microsoft\.Graph\..*?)\s+(\w+)\s+{\s+get\s+=>\s+\(\s*this\.(\w+)\s+=\s*this\.\3\s+\?\?\s+new\s+(Microsoft\.Graph\..*?)\s+set\s+=>\s+this._\w+\s+=\s+value;\s+}/gm, 'public $1 $2 { \n get => (this.$3 = this.$3 ?? new $4\n set\n {\n this.$3 = value;\n TrackProperty(nameof($2));\n }\n}') return $; @@ -495,62 +454,6 @@ directive: } }); } - - let nameSpacePrefixRegex = /(Microsoft(?:\.\w+)*?\.PowerShell)/gm - let nameSpacePrefix = 'Microsoft.Graph.PowerShell'; - if($.match(nameSpacePrefixRegex)){ - let prefixMatch = nameSpacePrefixRegex.exec($); - nameSpacePrefix = prefixMatch[1]; - } - - $ = $.replace( - /await this\.Client\.(\w+)\(\s*Headers\s*,\s*(BodyParameter|_body)\b([^;]+);/g, - (match, methodName, bodyParam, rest) => { - let ensureCall = ''; - - if (bodyParam === 'BodyParameter') { - ensureCall = ` - if (BodyParameter != null) - { - foreach (var prop in BodyParameter.GetType().GetProperties()) - { - // Skip indexer properties - if (prop.GetIndexParameters().Length == 0) - { - try - { - var val = prop.GetValue(BodyParameter); // force materialization - } - catch - {} - } - } - await ${nameSpacePrefix}.ModelExtensions.ModelExtensions.EnsurePropertiesAreReady(BodyParameter, failOnExplicitNulls: false); - }`; - } else if (bodyParam === '_body') { - ensureCall = ` - if (_body != null) - { - foreach (var prop in _body.GetType().GetProperties()) - { - // Skip indexer properties - if (prop.GetIndexParameters().Length == 0) - { - try - { - var val = prop.GetValue(_body); // force materialization - } - catch - {} - } - } - await ${nameSpacePrefix}.ModelExtensions.ModelExtensions.EnsurePropertiesAreReady(_body, failOnExplicitNulls: false); - }`; - } - - return `${ensureCall}\nawait this.Client.${methodName}(Headers, ${bodyParam}${rest};`; - } - ); return $; } @@ -754,16 +657,6 @@ directive: $ = $.replace(/cleanedBody = Microsoft.*.ReplaceAndRemoveSlashes\(cleanedBody\);/gm,'') - let nameSpacePrefixRegex = /(Microsoft(?:\.\w+)*?\.PowerShell)/gm - let nameSpacePrefix = 'Microsoft.Graph.PowerShell'; - if($.match(nameSpacePrefixRegex)){ - let prefixMatch = nameSpacePrefixRegex.exec($); - nameSpacePrefix = prefixMatch[1]; - } - $ = $.replace(/cleanedBody\s*=\s*body\.ToJson\(null\)\.ToString\(\);/g,'await '+nameSpacePrefix+'.ModelExtensions.ModelExtensions.EnsurePropertiesAreReady(body, failOnExplicitNulls: false);\n cleanedBody = body.ToJson(null).ToString();' - ); - $ = $.replace(/(^\s*)cleanedBody\s*=\s*Microsoft\.Graph\.(?:Beta\.)?PowerShell\.JsonUtilities\.JsonExtensions\.RemoveDefaultNullProperties\s*\(\s*jsonObject\s*\)\s*;/gm,'$1// cleanedBody = Microsoft.Graph.$2PowerShell.JsonUtilities.JsonExtensions.RemoveDefaultNullProperties(jsonObject);' - ); return $ } From 6307627f4aacbea35d04142b1d3bda0622473490 Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Thu, 8 May 2025 08:17:57 +0300 Subject: [PATCH 20/24] Found the issue. Uncommented users.Actions for one more test --- config/ModuleMetadata.json | 6 +++--- config/ModulesMapping.jsonc | 4 ++-- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/config/ModuleMetadata.json b/config/ModuleMetadata.json index 0c910b6b1d6..a50e31784e9 100644 --- a/config/ModuleMetadata.json +++ b/config/ModuleMetadata.json @@ -27,15 +27,15 @@ "versions": { "authentication": { "prerelease": "", - "version": "2.28.2" + "version": "2.28.3" }, "beta": { "prerelease": "", - "version": "2.28.2" + "version": "2.28.3" }, "v1.0": { "prerelease": "", - "version": "2.28.2" + "version": "2.28.3" } } } diff --git a/config/ModulesMapping.jsonc b/config/ModulesMapping.jsonc index ded0051a0f6..1b374555193 100644 --- a/config/ModulesMapping.jsonc +++ b/config/ModulesMapping.jsonc @@ -1,5 +1,5 @@ { -// "Applications": "^applicationTemplates\\.|^applications\\.|^servicePrincipals\\.|^onPremisesPublishingProfiles\\.|^users.appRoleAssignment$|^groups.appRoleAssignment$", + "Applications": "^applicationTemplates\\.|^applications\\.|^servicePrincipals\\.|^onPremisesPublishingProfiles\\.|^users.appRoleAssignment$|^groups.appRoleAssignment$", // "Bookings": "^bookingBusinesses\\.|^bookingCurrencies\\.|^solutions.booking.*.Actions$|^solutions.bookingBusiness$|^solutions.bookingCurrency$|^solutions.virtualEventsRoot$|^solutions.booking.*.Functions$|^solutions.solutionsRoot$", // "BusinessScenario": "^solutions.businessScenario$|^solutions.BusinessScenario.*.Actions$|^solutions.BusinessScenario.*.Functions$", // "BackupRestore": "^solutions.backupRestoreRoot$|^solutions.backupRestore.*.Actions$|^solutions.backupRestore.*.Functions$", @@ -38,7 +38,7 @@ // "Sites": "^sites.baseSitePage$|^sites.site$|^sites.itemAnalytics$|^sites.columnDefinition$|^sites.contentType$|^sites.drive$|^sites.list$|^sites.sitePage$|^sites.permission$|^sites.store$|^users.site$|^groups.site$|^sites.*.Functions$|^sites.*.Actions$|^sites.richLongRunningOperation$|^termStore.sets.ListChildren$|^admin.sharepoint$", // "Teams": "^teams\\.|^chats\\.|^users.chat$|^appCatalogs.teamsApp$|^users.userTeamwork$|^teamwork\\.|^users.team$|^groups.team$", "Users": "^users.user$|^users.directoryObject$|^users.licenseDetails$|^users.mailboxSettings|^users.notification$|^users.outlookUser$|^users.profilePhoto$|^users.userSettings$|^users.extension$|^users.oAuth2PermissionGrant$|^users.todo$|^users.itemInsights$|^users.servicePrincipal$", -// "Users.Actions": "^users.*.Actions$", + "Users.Actions": "^users.*.Actions$", // "Users.Functions": "^users.*.Functions$", // "WindowsUpdates": "^admin.adminWindows$" } \ No newline at end of file From 5d716294ff37a8df80d6e2bc9eec18cc9d32267b Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Thu, 8 May 2025 10:22:00 +0300 Subject: [PATCH 21/24] Rolled back module mapping and module metadata --- config/ModuleMetadata.json | 6 +- config/ModulesMapping.jsonc | 88 +++++++++++++------------- tools/Custom/ModelExtensions.cs | 106 -------------------------------- 3 files changed, 47 insertions(+), 153 deletions(-) delete mode 100644 tools/Custom/ModelExtensions.cs diff --git a/config/ModuleMetadata.json b/config/ModuleMetadata.json index a50e31784e9..6f07e7cdcb0 100644 --- a/config/ModuleMetadata.json +++ b/config/ModuleMetadata.json @@ -27,15 +27,15 @@ "versions": { "authentication": { "prerelease": "", - "version": "2.28.3" + "version": "2.28.0" }, "beta": { "prerelease": "", - "version": "2.28.3" + "version": "2.28.0" }, "v1.0": { "prerelease": "", - "version": "2.28.3" + "version": "2.28.0" } } } diff --git a/config/ModulesMapping.jsonc b/config/ModulesMapping.jsonc index 1b374555193..4e1ea5835bf 100644 --- a/config/ModulesMapping.jsonc +++ b/config/ModulesMapping.jsonc @@ -1,44 +1,44 @@ - { - "Applications": "^applicationTemplates\\.|^applications\\.|^servicePrincipals\\.|^onPremisesPublishingProfiles\\.|^users.appRoleAssignment$|^groups.appRoleAssignment$", -// "Bookings": "^bookingBusinesses\\.|^bookingCurrencies\\.|^solutions.booking.*.Actions$|^solutions.bookingBusiness$|^solutions.bookingCurrency$|^solutions.virtualEventsRoot$|^solutions.booking.*.Functions$|^solutions.solutionsRoot$", -// "BusinessScenario": "^solutions.businessScenario$|^solutions.BusinessScenario.*.Actions$|^solutions.BusinessScenario.*.Functions$", -// "BackupRestore": "^solutions.backupRestoreRoot$|^solutions.backupRestore.*.Actions$|^solutions.backupRestore.*.Functions$", -// "Calendar": "^places\\.|^users.calendar$|^users.calendarGroup$|^users.event$|^groups.calendar$|^groups.event$", -// "ChangeNotifications": "^subscriptions\\.", -// "CloudCommunications": "^users.onlineMeeting$|^users.presence$|^communications\\.", -// "Compliance": "^compliance\\.|^privacy.subjectRightsRequest$", -// "CrossDeviceExperiences": "^users.userActivity$|^users.device$", -// "Devices.CloudPrint": "^print\\.", -// "Devices.CorporateManagement": "^deviceAppManagement\\.|^officeConfiguration\\.|^users.mobileAppIntentAndState$|^users.mobileAppTroubleshootingEvent$|^users.windowsInformationProtectionDeviceRegistration$|^users.managedAppRegistration$|^users.managedDevice$|^users.deviceManagementTroubleshootingEvent$|^users.deviceEnrollmentConfiguration$", -// "Devices.ServiceAnnouncement": "^admin.serviceAnnouncement$|^admin.*.Actions$|^admin.*.Functions$", -// "DeviceManagement": "^deviceManagement.(deviceCompliancePolicy.*|deviceManagementConfigurationPolicy.*|deviceManagementCompliancePolicy.*|deviceManagementConfigurationSettingDefinition.*|deviceConfiguration.*|managedDevice.*|managementCondition.*|microsoftTunnel.*|windowsInformationProtection.*|deviceManagement|deviceManagement(DerivedCredentialSettings|Intent|ResourceAccessProfileBase|Script|SettingCategory|SettingDefinition|Template|TroubleshootingEvent)|androidForWork(AppConfigurationSchema|Settings)|androidManagedStore(AccountEnterpriseSettings|AppConfigurationSchema)|deviceAndAppManagementAssignmentFilter|deviceCategory|advancedThreatProtectionOnboardingStateSummary|dataSharingConsent|detectedApp|deviceHealthScript|deviceShellScript|embeddedSIMActivationCodePool|groupPolicyConfiguration|macOSSoftwareUpdateAccountSummary|mobileAppTroubleshootingEvent|notificationMessageTemplate|remoteActionAudit|softwareUpdateStatusSummary|windowsMalwareInformation|windowsQualityUpdateProfile)$|^admin.edge$|^deviceManagement.monitoring$|^users.ListCloudPCs$", -// "DeviceManagement.Administration": "^deviceManagement.(virtualEndpoint.*|.*Partner.*|.*Certificate.*|.*role.*|deviceManagement(DomainJoinConnector|ExchangeConnector|ExchangeOnPremisesPolicy)|groupPolicy(Category|Definition|DefinitionFile|MigrationReport|ObjectFile|UploadedDefinitionFile)|auditEvent|cartToClassAssociation|comanagementEligibleDevice|deviceAndAppManagementRoleAssignment|intuneBrandingProfile|iosUpdateDeviceStatus|mobileThreatDefenseConnector|ndesConnector|resourceOperation|restrictedAppsViolation|termsAndConditions)", -// "DeviceManagement.Enrollment": "^deviceManagement.(.*Enrollment.*|.*Autopilot.*|.*depOnboarding.*|importedDeviceIdentity|onPremisesConditionalAccessSettings|windowsFeatureUpdateProfile)$|^roleManagement.roleManagement$|^roleManagement.rbacApplicationMultiple$|^roleManagement.unifiedRbacApplication$", -// "DeviceManagement.Functions": "^deviceManagement.*.Functions$", -// "DirectoryObjects": "^directoryObjects\\.|^directory.publicKeyInfrastructureRoot$", - // "Education": "^education\\.", -// "Files": "^drives\\.|^shares\\.|^users.drive$|^groups.drive$", -// "Financials": "^financials\\.", - "Groups": "^groups.group$|^groups.directoryObject$|^groups.conversation$|^groups.endpoint$|^groups.extension$|^groups.groupLifecyclePolicy$|^groups.resourceSpecificPermissionGrant$|^groups.profilePhoto$|^groups.conversationThread$|^groupLifecyclePolicies\\.|^users.group$|^groups.directorySetting$|^groups.*.Actions$|^groups.*.Functions$|^groupSettings\\.|^groups.groupSetting$|^groupSettingTemplates\\.", -// "Identity.DirectoryManagement": "^administrativeUnits\\.|^contacts\\.|^devices\\.|^domains\\.|^directoryRoles\\.|^directoryRoleTemplates\\.|^directorySettingTemplates\\.|^settings\\.|^subscribedSkus\\.|^contracts\\.|^directory\\.|^users.scopedRoleMembership$|^organization.organization$|^organization.organizationalBranding$|^organization.organizationSettings$|^organization.*.Actions$|^organization.extension$|^tenantRelationships.*.Actions$|^tenantRelationships.*.Functions$|admin.peopleAdminSettings$|^organization\\.partnerInformation$", -// "Identity.Governance": "^accessReviews\\.|^businessFlowTemplates\\.|^programs\\.|^programControls\\.|^programControlTypes\\.|^privilegedRoles\\.|^privilegedRoleAssignments\\.|^privilegedRoleAssignmentRequests\\.|^privilegedApproval\\.|^privilegedOperationEvents\\.|^privilegedAccess\\.|^agreements\\.|^users.agreementAcceptance$|^identityGovernance\\.|^roleManagement.rbacApplication$|^roleManagement.*.Functions$|roleManagement.*.Actions$", - // "Identity.SignIns": "^organization.certificateBasedAuthConfiguration$|^invitations\\.|^identityProviders\\.|^oauth2PermissionGrants\\.|^identityProtection\\.|^dataPolicyOperations\\.|^identity\\.|^trustFramework\\.|^informationProtection\\.|^policies\\.|^users.authentication$|^users.informationProtection$|^tenantRelationships.multiTenantOrganization$|^policies.deviceRegistrationPolicy$|^policies.deviceRegistrationPolicy$", -// "Identity.Partner": "^tenantRelationships.delegatedAdminRelationship$|^tenantRelationships.delegatedAdminCustomer$", -// "Mail": "^users.inferenceClassification$|^users.mailFolder$|^users.message$", -// "ManagedTenants": "^tenantRelationships.managedTenant$", -// "NetworkAccess": "^networkAccess\\.", -// "Notes": "^users.onenote$|^groups.onenote$|^sites.onenote$", - // "People": "^users.person$|^users.profile$|^users.officeGraphInsights$|^users.userAnalytics$", -// "PersonalContacts": "^users.contactFolder$|^users.contact$", -// "Planner": "^planner\\.|^users.plannerUser$|^groups.plannerGroup$", -// "Reports": "^reports\\.|^auditLogs\\.|^deviceManagement.deviceManagementReports$|^admin.adminReportSetting", -// "SchemaExtensions": "^schemaExtensions\\.", -// "Search": "^search\\.|^external\\.", - "Security": "^security\\.|^users.security$", -// "Sites": "^sites.baseSitePage$|^sites.site$|^sites.itemAnalytics$|^sites.columnDefinition$|^sites.contentType$|^sites.drive$|^sites.list$|^sites.sitePage$|^sites.permission$|^sites.store$|^users.site$|^groups.site$|^sites.*.Functions$|^sites.*.Actions$|^sites.richLongRunningOperation$|^termStore.sets.ListChildren$|^admin.sharepoint$", -// "Teams": "^teams\\.|^chats\\.|^users.chat$|^appCatalogs.teamsApp$|^users.userTeamwork$|^teamwork\\.|^users.team$|^groups.team$", - "Users": "^users.user$|^users.directoryObject$|^users.licenseDetails$|^users.mailboxSettings|^users.notification$|^users.outlookUser$|^users.profilePhoto$|^users.userSettings$|^users.extension$|^users.oAuth2PermissionGrant$|^users.todo$|^users.itemInsights$|^users.servicePrincipal$", - "Users.Actions": "^users.*.Actions$", -// "Users.Functions": "^users.*.Functions$", -// "WindowsUpdates": "^admin.adminWindows$" - } \ No newline at end of file +{ + "Applications": "^applicationTemplates\\.|^applications\\.|^servicePrincipals\\.|^onPremisesPublishingProfiles\\.|^users.appRoleAssignment$|^groups.appRoleAssignment$", + "Bookings": "^bookingBusinesses\\.|^bookingCurrencies\\.|^solutions.booking.*.Actions$|^solutions.bookingBusiness$|^solutions.bookingCurrency$|^solutions.virtualEventsRoot$|^solutions.booking.*.Functions$|^solutions.solutionsRoot$", + "BusinessScenario": "^solutions.businessScenario$|^solutions.BusinessScenario.*.Actions$|^solutions.BusinessScenario.*.Functions$", + "BackupRestore": "^solutions.backupRestoreRoot$|^solutions.backupRestore.*.Actions$|^solutions.backupRestore.*.Functions$", + "Calendar": "^places\\.|^users.calendar$|^users.calendarGroup$|^users.event$|^groups.calendar$|^groups.event$", + "ChangeNotifications": "^subscriptions\\.", + "CloudCommunications": "^users.onlineMeeting$|^users.presence$|^communications\\.", + "Compliance": "^compliance\\.|^privacy.subjectRightsRequest$", + "CrossDeviceExperiences": "^users.userActivity$|^users.device$", + "Devices.CloudPrint": "^print\\.", + "Devices.CorporateManagement": "^deviceAppManagement\\.|^officeConfiguration\\.|^users.mobileAppIntentAndState$|^users.mobileAppTroubleshootingEvent$|^users.windowsInformationProtectionDeviceRegistration$|^users.managedAppRegistration$|^users.managedDevice$|^users.deviceManagementTroubleshootingEvent$|^users.deviceEnrollmentConfiguration$", + "Devices.ServiceAnnouncement": "^admin.serviceAnnouncement$|^admin.*.Actions$|^admin.*.Functions$", + "DeviceManagement": "^deviceManagement.(deviceCompliancePolicy.*|deviceManagementConfigurationPolicy.*|deviceManagementCompliancePolicy.*|deviceManagementConfigurationSettingDefinition.*|deviceConfiguration.*|managedDevice.*|managementCondition.*|microsoftTunnel.*|windowsInformationProtection.*|deviceManagement|deviceManagement(DerivedCredentialSettings|Intent|ResourceAccessProfileBase|Script|SettingCategory|SettingDefinition|Template|TroubleshootingEvent)|androidForWork(AppConfigurationSchema|Settings)|androidManagedStore(AccountEnterpriseSettings|AppConfigurationSchema)|deviceAndAppManagementAssignmentFilter|deviceCategory|advancedThreatProtectionOnboardingStateSummary|dataSharingConsent|detectedApp|deviceHealthScript|deviceShellScript|embeddedSIMActivationCodePool|groupPolicyConfiguration|macOSSoftwareUpdateAccountSummary|mobileAppTroubleshootingEvent|notificationMessageTemplate|remoteActionAudit|softwareUpdateStatusSummary|windowsMalwareInformation|windowsQualityUpdateProfile)$|^admin.edge$|^deviceManagement.monitoring$|^users.ListCloudPCs$", + "DeviceManagement.Administration": "^deviceManagement.(virtualEndpoint.*|.*Partner.*|.*Certificate.*|.*role.*|deviceManagement(DomainJoinConnector|ExchangeConnector|ExchangeOnPremisesPolicy)|groupPolicy(Category|Definition|DefinitionFile|MigrationReport|ObjectFile|UploadedDefinitionFile)|auditEvent|cartToClassAssociation|comanagementEligibleDevice|deviceAndAppManagementRoleAssignment|intuneBrandingProfile|iosUpdateDeviceStatus|mobileThreatDefenseConnector|ndesConnector|resourceOperation|restrictedAppsViolation|termsAndConditions)", + "DeviceManagement.Enrollment": "^deviceManagement.(.*Enrollment.*|.*Autopilot.*|.*depOnboarding.*|importedDeviceIdentity|onPremisesConditionalAccessSettings|windowsFeatureUpdateProfile)$|^roleManagement.roleManagement$|^roleManagement.rbacApplicationMultiple$|^roleManagement.unifiedRbacApplication$", + "DeviceManagement.Functions": "^deviceManagement.*.Functions$", + "DirectoryObjects": "^directoryObjects\\.|^directory.publicKeyInfrastructureRoot$", + "Education": "^education\\.", + "Files": "^drives\\.|^shares\\.|^users.drive$|^groups.drive$", + "Financials": "^financials\\.", + "Groups": "^groups.group$|^groups.directoryObject$|^groups.conversation$|^groups.endpoint$|^groups.extension$|^groups.groupLifecyclePolicy$|^groups.resourceSpecificPermissionGrant$|^groups.profilePhoto$|^groups.conversationThread$|^groupLifecyclePolicies\\.|^users.group$|^groups.directorySetting$|^groups.*.Actions$|^groups.*.Functions$|^groupSettings\\.|^groups.groupSetting$|^groupSettingTemplates\\.", + "Identity.DirectoryManagement": "^administrativeUnits\\.|^contacts\\.|^devices\\.|^domains\\.|^directoryRoles\\.|^directoryRoleTemplates\\.|^directorySettingTemplates\\.|^settings\\.|^subscribedSkus\\.|^contracts\\.|^directory\\.|^users.scopedRoleMembership$|^organization.organization$|^organization.organizationalBranding$|^organization.organizationSettings$|^organization.*.Actions$|^organization.extension$|^tenantRelationships.*.Actions$|^tenantRelationships.*.Functions$|admin.peopleAdminSettings$|^organization\\.partnerInformation$", + "Identity.Governance": "^accessReviews\\.|^businessFlowTemplates\\.|^programs\\.|^programControls\\.|^programControlTypes\\.|^privilegedRoles\\.|^privilegedRoleAssignments\\.|^privilegedRoleAssignmentRequests\\.|^privilegedApproval\\.|^privilegedOperationEvents\\.|^privilegedAccess\\.|^agreements\\.|^users.agreementAcceptance$|^identityGovernance\\.|^roleManagement.rbacApplication$|^roleManagement.*.Functions$|roleManagement.*.Actions$", + "Identity.SignIns": "^organization.certificateBasedAuthConfiguration$|^invitations\\.|^identityProviders\\.|^oauth2PermissionGrants\\.|^identityProtection\\.|^dataPolicyOperations\\.|^identity\\.|^trustFramework\\.|^informationProtection\\.|^policies\\.|^users.authentication$|^users.informationProtection$|^tenantRelationships.multiTenantOrganization$|^policies.deviceRegistrationPolicy$|^policies.deviceRegistrationPolicy$", + "Identity.Partner": "^tenantRelationships.delegatedAdminRelationship$|^tenantRelationships.delegatedAdminCustomer$", + "Mail": "^users.inferenceClassification$|^users.mailFolder$|^users.message$", + "ManagedTenants": "^tenantRelationships.managedTenant$", + "NetworkAccess": "^networkAccess\\.", + "Notes": "^users.onenote$|^groups.onenote$|^sites.onenote$", + "People": "^users.person$|^users.profile$|^users.officeGraphInsights$|^users.userAnalytics$", + "PersonalContacts": "^users.contactFolder$|^users.contact$", + "Planner": "^planner\\.|^users.plannerUser$|^groups.plannerGroup$", + "Reports": "^reports\\.|^auditLogs\\.|^deviceManagement.deviceManagementReports$|^admin.adminReportSetting", + "SchemaExtensions": "^schemaExtensions\\.", + "Search": "^search\\.|^external\\.", + "Security": "^security\\.|^users.security$", + "Sites": "^sites.baseSitePage$|^sites.site$|^sites.itemAnalytics$|^sites.columnDefinition$|^sites.contentType$|^sites.drive$|^sites.list$|^sites.sitePage$|^sites.permission$|^sites.store$|^users.site$|^groups.site$|^sites.*.Functions$|^sites.*.Actions$|^sites.richLongRunningOperation$|^termStore.sets.ListChildren$|^admin.sharepoint$", + "Teams": "^teams\\.|^chats\\.|^users.chat$|^appCatalogs.teamsApp$|^users.userTeamwork$|^teamwork\\.|^users.team$|^groups.team$", + "Users": "^users.user$|^users.directoryObject$|^users.licenseDetails$|^users.mailboxSettings|^users.notification$|^users.outlookUser$|^users.profilePhoto$|^users.userSettings$|^users.extension$|^users.oAuth2PermissionGrant$|^users.todo$|^users.itemInsights$|^users.servicePrincipal$", + "Users.Actions": "^users.*.Actions$", + "Users.Functions": "^users.*.Functions$", + "WindowsUpdates": "^admin.adminWindows$" +} diff --git a/tools/Custom/ModelExtensions.cs b/tools/Custom/ModelExtensions.cs deleted file mode 100644 index 17898921967..00000000000 --- a/tools/Custom/ModelExtensions.cs +++ /dev/null @@ -1,106 +0,0 @@ -using System; -using System.Linq; -using System.Reflection; -using System.Collections; -using System.Threading.Tasks; -using NamespacePrefixPlaceholder.PowerShell.Runtime; - -namespace NamespacePrefixPlaceholder.PowerShell.ModelExtensions -{ - public static class ModelExtensions - { - public static async Task EnsurePropertiesAreReady( - this object model, - bool failOnExplicitNulls = false, - int retries = 3, - int delayMs = 1000, - bool debug = false) - { - if (model == null) - throw new ArgumentNullException(nameof(model)); - - var modelType = model.GetType(); - var isSetMethod = modelType.GetMethod("IsPropertySet", BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic); - - if (isSetMethod == null) - return; // Skip if model doesn't support property tracking - - for (int attempt = 0; attempt < retries; attempt++) - { - bool allReady = true; - foreach (var prop in modelType.GetProperties(BindingFlags.Public | BindingFlags.Instance)) - { - if (!prop.CanRead) continue; - - bool isSet = (bool)isSetMethod.Invoke(model, new object[] { prop.Name }); - object value = null; - - try - { - value = prop.GetValue(model); - } - catch { /* Handle properties that might throw on get */ } - - if (debug) - Console.WriteLine($"DEBUG: Property={prop.Name}, IsSet={isSet}, Value={(value == null ? "null" : value.ToString())}"); - - if (!isSet) - continue; // skip unset properties - - if (value == null && failOnExplicitNulls) - { - allReady = false; - break; - } - - if (value != null && IsDefault(value) && failOnExplicitNulls) - { - allReady = false; - break; - } - - // Recursively check nested models - if (value != null && !IsSimple(value)) - { - if (value is IEnumerable enumerable && !(value is string)) - { - foreach (var item in enumerable) - await EnsurePropertiesAreReady(item, failOnExplicitNulls, 1, 0, debug); - } - else - { - await EnsurePropertiesAreReady(value, failOnExplicitNulls, 1, 0, debug); - } - } - } - - if (allReady) - return; - - if (attempt < retries - 1) - await Task.Delay(delayMs); - } - - throw new InvalidOperationException("One or more required properties were not ready after retries."); - } - - private static bool IsSimple(object obj) - { - var type = obj.GetType(); - return type.IsPrimitive - || type.IsEnum - || type == typeof(string) - || type == typeof(DateTime) - || type == typeof(decimal) - || type == typeof(Guid) - || type == typeof(TimeSpan); - } - - private static bool IsDefault(object obj) - { - var type = obj.GetType(); - object defaultValue = type.IsValueType ? Activator.CreateInstance(type) : null; - return Equals(obj, defaultValue); - } - } -} From 9adbb0fc554c09a6046ceb6ea16b98a5e6969094 Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Thu, 8 May 2025 10:34:07 +0300 Subject: [PATCH 22/24] Rolled back education file --- openApiDocs/v1.0/Education.yml | 13989 ++++++++++++++++++++++++++++++- 1 file changed, 13988 insertions(+), 1 deletion(-) diff --git a/openApiDocs/v1.0/Education.yml b/openApiDocs/v1.0/Education.yml index 6d984180a3e..d1311f54922 100644 --- a/openApiDocs/v1.0/Education.yml +++ b/openApiDocs/v1.0/Education.yml @@ -6,7 +6,120 @@ servers: - url: https://graph.microsoft.com/v1.0/ description: Core paths: + /education: + get: + tags: + - education.educationRoot + summary: Get education + operationId: education.educationRoot_GetEducationRoot + parameters: + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved entity + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRoot' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationRoot + summary: Update education + operationId: education.educationRoot_UpdateEducationRoot + requestBody: + description: New property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRoot' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRoot' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation /education/classes: + get: + tags: + - education.educationClass + summary: List educationClasses + description: Get a list of the educationClass objects and their properties. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-list?view=graph-rest-1.0 + operationId: education_ListClass + parameters: + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationClassCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation post: tags: - education.educationClass @@ -33,6 +146,13880 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}': + get: + tags: + - education.educationClass + summary: Get educationClass + description: 'Retrieve a class from the system. A class is a universal group with a special property that indicates to the system that the group is a class. Group members represent the students; group admins represent the teachers in the class. If you''re using the delegated token, the user will only see classes in which they are members.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-get?view=graph-rest-1.0 + operationId: education_GetClass + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationClass' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationClass + summary: Update educationClass + description: Update the properties of an educationClass object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-update?view=graph-rest-1.0 + operationId: education_UpdateClass + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationClass' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationClass' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationClass + summary: Delete educationClass + description: 'Delete an educationClass. Because a class is also a universal group, deleting a class deletes the group.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-delete?view=graph-rest-1.0 + operationId: education_DeleteClass + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignmentCategories': + get: + tags: + - education.educationClass + summary: List assignmentCategories + description: Retrieve a list of educationCategory objects. Only teachers can perform this operation. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-list-categories?view=graph-rest-1.0 + operationId: education.class_ListAssignmentCategory + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationCategoryCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationClass + summary: Create educationCategory + description: Create a new educationCategory on an educationClass. Only teachers can perform this operation. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-post-category?view=graph-rest-1.0 + operationId: education.class_CreateAssignmentCategory + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationCategory' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationCategory' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignmentCategories/{educationCategory-id}': + get: + tags: + - education.educationClass + summary: Get educationCategory + description: 'Retrieve an educationCategory object. Only teachers, students, and applications with application permissions can perform this operation.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationcategory-get?view=graph-rest-1.0 + operationId: education.class_GetAssignmentCategory + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationCategory-id + in: path + description: The unique identifier of educationCategory + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationCategory + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationCategory' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationClass + summary: Update the navigation property assignmentCategories in education + operationId: education.class_UpdateAssignmentCategory + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationCategory-id + in: path + description: The unique identifier of educationCategory + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationCategory + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationCategory' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationCategory' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationClass + summary: Delete educationCategory + description: Delete an existing category. Only teachers can perform this operation. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationcategory-delete?view=graph-rest-1.0 + operationId: education.class_DeleteAssignmentCategory + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationCategory-id + in: path + description: The unique identifier of educationCategory + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationCategory + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignmentCategories/$count': + get: + tags: + - education.educationClass + summary: Get the number of the resource + operationId: education.class.assignmentCategory_GetCount + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/classes/{educationClass-id}/assignmentCategories/microsoft.graph.delta()': + get: + tags: + - education.educationClass + summary: Invoke function delta + description: Get a list of newly created or updated educationCategory objects without having to perform a full read of the collection. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationcategory-delta?view=graph-rest-1.0 + operationId: education.class.assignmentCategory_delta + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Success + content: + application/json: + schema: + title: Collection of educationCategory + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.educationCategory' + '@odata.nextLink': + type: string + nullable: true + '@odata.deltaLink': + type: string + nullable: true + additionalProperties: + type: object + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: function + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + '/education/classes/{educationClass-id}/assignmentDefaults': + get: + tags: + - education.educationClass + summary: Get educationAssignmentDefaults + description: Read the properties and relationships of an educationAssignmentDefaults object. These are the class-level assignment defaults respected by new assignments created in the class. Callers can continue to specify custom values on each assignment creation if they don't want the default behaviors. Only teachers can perform this operation. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignmentdefaults-get?view=graph-rest-1.0 + operationId: education.class_GetAssignmentDefault + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignmentDefaults' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationClass + summary: Update educationAssignmentDefaults + description: Update the properties of an educationAssignmentDefaults object. Only teachers can update these settings. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignmentdefaults-update?view=graph-rest-1.0 + operationId: education.class_UpdateAssignmentDefault + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignmentDefaults' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignmentDefaults' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationClass + summary: Delete navigation property assignmentDefaults for education + operationId: education.class_DeleteAssignmentDefault + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignments': + get: + tags: + - education.educationClass + summary: List class assignments + description: 'Retrieve a list of assignment objects. Only teachers, students, and applications with application permissions can perform this operation. A teacher, or an application running with application permissions, can see all assignment objects for the class. Students can only see assignments that are assigned to them.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-list-assignments?view=graph-rest-1.0 + operationId: education.class_ListAssignment + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationAssignmentCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationClass + summary: Create educationAssignment + description: 'Create a new assignment. Only teachers in a class can create an assignment. Assignments start in draft status, which means that students can''t see the assignment until it''s published.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-post-assignment?view=graph-rest-1.0 + operationId: education.class_CreateAssignment + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}': + get: + tags: + - education.educationClass + summary: Get educationAssignment + description: 'Get the properties and relationships of an assignment. Only teachers, students, and applications with application permissions can perform this operation. Students can only see assignments assigned to them; teachers and applications with application permissions can see all assignments in a class. You can use the Prefer header in your request to get the inactive status in case the assignment is deactivated; otherwise, the response value for the status property is unknownFutureValue.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-get?view=graph-rest-1.0 + operationId: education.class_GetAssignment + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationClass + summary: Update educationassignment + description: 'Update an educationAssignment object. Only teachers can perform this action. Alternatively, request to change the status of an assignment with publish action. Don''t use a PATCH operation for this purpose.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-update?view=graph-rest-1.0 + operationId: education.class_UpdateAssignment + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationClass + summary: Delete educationAssignment + description: Delete an existing assignment. Only teachers within a class can delete assignments. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-delete?view=graph-rest-1.0 + operationId: education.class_DeleteAssignment + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/categories': + get: + tags: + - education.educationClass + summary: List categories + description: 'List all the categories associated with an assignment. Only teachers, students, and applications with application permissions can perform this operation.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-list-categories?view=graph-rest-1.0 + operationId: education.class.assignment_ListCategory + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationCategoryCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationClass + summary: Create educationCategories + description: Add one or more existing educationCategory objects to the specified educationAssignment. Only teachers can perform this operation. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-post-categories?view=graph-rest-1.0 + operationId: education.class.assignment_CreateCategory + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationCategory' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationCategory' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/categories/{educationCategory-id}/$ref': + delete: + tags: + - education.educationClass + summary: Remove educationCategory + description: Remove an educationCategory from an educationAssignment. Only teachers can perform this operation. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-remove-category?view=graph-rest-1.0 + operationId: education.class.assignment.category_DeleteEducationCategoryGraphBPreRef + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationCategory-id + in: path + description: The unique identifier of educationCategory + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationCategory + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/categories/$count': + get: + tags: + - education.educationClass + summary: Get the number of the resource + operationId: education.class.assignment.category_GetCount + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/categories/$ref': + get: + tags: + - education.educationClass + summary: List categories + description: 'List all the categories associated with an assignment. Only teachers, students, and applications with application permissions can perform this operation.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-list-categories?view=graph-rest-1.0 + operationId: education.class.assignment_ListCategoryGraphBPreRef + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/StringCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationClass + summary: Create educationCategories + description: Add one or more existing educationCategory objects to the specified educationAssignment. Only teachers can perform this operation. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-post-categories?view=graph-rest-1.0 + operationId: education.class.assignment_CreateCategoryGraphBPreRef + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + requestBody: + $ref: '#/components/requestBodies/refPostBody' + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationClass + summary: Remove educationCategory + description: Remove an educationCategory from an educationAssignment. Only teachers can perform this operation. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-remove-category?view=graph-rest-1.0 + operationId: education.class.assignment_DeleteCategoryGraphBPreRef + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + - name: '@id' + in: query + description: The delete Uri + required: true + style: form + explode: false + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/categories/microsoft.graph.delta()': + get: + tags: + - education.educationClass + summary: Invoke function delta + description: Get a list of newly created or updated educationCategory objects without having to perform a full read of the collection. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationcategory-delta?view=graph-rest-1.0 + operationId: education.class.assignment.category_delta + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Success + content: + application/json: + schema: + title: Collection of educationCategory + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.educationCategory' + '@odata.nextLink': + type: string + nullable: true + '@odata.deltaLink': + type: string + nullable: true + additionalProperties: + type: object + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: function + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/gradingCategory': + get: + tags: + - education.educationClass + summary: Get gradingCategory from education + description: 'When set, enables users to weight assignments differently when computing a class average grade.' + operationId: education.class.assignment_GetGradingCategory + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationGradingCategory' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/microsoft.graph.activate': + post: + tags: + - education.educationClass + summary: Invoke action activate + description: Activate an inactive educationAssignment to signal that the assignment has further action items for teachers or students. This action can only be performed by a teacher on currently inactive assignments. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-activate?view=graph-rest-1.0 + operationId: education.class.assignment_activate + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/microsoft.graph.deactivate': + post: + tags: + - education.educationClass + summary: Invoke action deactivate + description: Mark an assigned educationAssignment as inactive to signal that the assignment has no further action items for teachers and students. This action can only be performed by a teacher on assigned assignments. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-deactivate?view=graph-rest-1.0 + operationId: education.class.assignment_deactivate + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/microsoft.graph.publish': + post: + tags: + - education.educationClass + summary: Invoke action publish + description: 'Publish an education assignment. Change the status of an educationAssignment from its original draft status to the published status. You can change the status from draft to scheduled if the assignment is scheduled for a future date. Only a teacher in the class can make this call. When an assignment is in draft status, students will not see the assignment, nor will there be any submission objects. Calling this API creates educationSubmission objects and displays the assignment in each student''s list. The status of the assignment goes back to draft if there is any backend failure during publish process. To update the properties of a published assignment, see update an assignment.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-publish?view=graph-rest-1.0 + operationId: education.class.assignment_publish + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/microsoft.graph.setUpFeedbackResourcesFolder': + post: + tags: + - education.educationClass + summary: Invoke action setUpFeedbackResourcesFolder + description: Create a SharePoint folder to upload feedback files for a given educationSubmission. Only teachers can perform this operation. The teacher determines the resources to upload in the feedback resources folder of a submission. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-setupfeedbackresourcesfolder?view=graph-rest-1.0 + operationId: education.class.assignment_setUpFeedbackResourcesFolder + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/microsoft.graph.setUpResourcesFolder': + post: + tags: + - education.educationClass + summary: Invoke action setUpResourcesFolder + description: 'Create a SharePoint folder to upload files for a given educationAssignment. Only teachers can perform this operation. The teacher determines the resources to upload in the assignment''s folder. ' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-setupresourcesfolder?view=graph-rest-1.0 + operationId: education.class.assignment_setUpResourcesFolder + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/resources': + get: + tags: + - education.educationClass + summary: List assignment resources + description: 'Get all the educationAssignmentResource objects associated with an assignment. Only teachers, students, and applications with application permissions can perform this operation.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-list-resources?view=graph-rest-1.0 + operationId: education.class.assignment_ListResource + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationAssignmentResourceCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationClass + summary: Create educationAssignmentResource + description: 'Create an assignment resource. Only teachers can perform this operation. You can create the following types of assignment resources: Every resource has an @odata.type property to indicate which type of resource is being created.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-post-resource?view=graph-rest-1.0 + operationId: education.class.assignment_CreateResource + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/resources/{educationAssignmentResource-id}': + get: + tags: + - education.educationClass + summary: Get educationAssignmentResource + description: 'Get the properties of an education assignment resource associated with an assignment. Only teachers, students, and applications with application permissions can perform this operation.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignmentresource-get?view=graph-rest-1.0 + operationId: education.class.assignment_GetResource + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationAssignmentResource-id + in: path + description: The unique identifier of educationAssignmentResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignmentResource + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationClass + summary: Update the navigation property resources in education + operationId: education.class.assignment_UpdateResource + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationAssignmentResource-id + in: path + description: The unique identifier of educationAssignmentResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignmentResource + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationClass + summary: Delete educationAssignmentResource + description: 'Delete a specific educationAssignmentResource attached to an assignment. In general, only teachers in the class can remove a resource. However, teachers can''t remove resources marked as ''distributeToStudents'', after the assignment has been published to students.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignmentresource-delete?view=graph-rest-1.0 + operationId: education.class.assignment_DeleteResource + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationAssignmentResource-id + in: path + description: The unique identifier of educationAssignmentResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignmentResource + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/resources/$count': + get: + tags: + - education.educationClass + summary: Get the number of the resource + operationId: education.class.assignment.resource_GetCount + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/rubric': + get: + tags: + - education.educationClass + summary: Get educationRubric attached to educationAssignment + description: 'Get the educationRubric object attached to an educationAssignment, if one exists. Only teachers, students, and applications with application permissions can perform this operation.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-get-rubric?view=graph-rest-1.0 + operationId: education.class.assignment_GetRubric + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRubric' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationClass + summary: Attach educationRubric to an assignment + description: Attach an existing educationRubric object to an educationAssignment. Only teachers can perform this operation. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-put-rubric?view=graph-rest-1.0 + operationId: education.class.assignment_UpdateRubric + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRubric' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRubric' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationClass + summary: Delete educationRubric from educationAssignment + description: Remove an educationRubric from an educationAssignment. This method doesn't delete the rubric itself and can only be performed by teachers. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-delete-rubric?view=graph-rest-1.0 + operationId: education.class.assignment_DeleteRubric + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/rubric/$ref': + get: + tags: + - education.educationClass + summary: Get educationRubric attached to educationAssignment + description: 'Get the educationRubric object attached to an educationAssignment, if one exists. Only teachers, students, and applications with application permissions can perform this operation.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-get-rubric?view=graph-rest-1.0 + operationId: education.class.assignment_GetRubricGraphBPreRef + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + responses: + 2XX: + description: Retrieved navigation property link + content: + application/json: + schema: + type: string + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + put: + tags: + - education.educationClass + summary: Attach educationRubric to an assignment + description: Attach an existing educationRubric object to an educationAssignment. Only teachers can perform this operation. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-put-rubric?view=graph-rest-1.0 + operationId: education.class.assignment_SetRubricGraphBPreRef + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + requestBody: + $ref: '#/components/requestBodies/refPutBody' + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationClass + summary: Delete educationRubric from educationAssignment + description: Remove an educationRubric from an educationAssignment. This method doesn't delete the rubric itself and can only be performed by teachers. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-delete-rubric?view=graph-rest-1.0 + operationId: education.class.assignment_DeleteRubricGraphBPreRef + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions': + get: + tags: + - education.educationClass + summary: List submissions + description: 'List all the submissions associated with an assignment. Only teachers, students, and applications with application permissions can perform this operation. A teacher or an application with application permissions can get all the submissions while a student can only get submissions that they''re associated with.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-list-submissions?view=graph-rest-1.0 + operationId: education.class.assignment_ListSubmission + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationSubmissionCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationClass + summary: Create new navigation property to submissions for education + operationId: education.class.assignment_CreateSubmission + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}': + get: + tags: + - education.educationClass + summary: Get educationSubmission + description: 'Retrieve a particular submission. Only teachers, students, and applications with application permissions can perform this operation. A submission object represents a student''s work for an assignment. Resources associated with the submission represent this work. Only the assignedTo student can see and modify the submission. A teacher or application with application permissions has full access to all submissions. The grade and feedback from a teacher are part of the educationOutcome associated with this object. Only teachers or applications with application permissions can add or change grades and feedback. Students will not see the grade or feedback until the assignment has been released.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-get?view=graph-rest-1.0 + operationId: education.class.assignment_GetSubmission + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationClass + summary: Update the navigation property submissions in education + operationId: education.class.assignment_UpdateSubmission + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationClass + summary: Delete navigation property submissions for education + operationId: education.class.assignment_DeleteSubmission + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.excuse': + post: + tags: + - education.educationClass + summary: Invoke action excuse + description: 'Excuse a submission. Excused submissions aren''t included in average grade calculations. Grading rubrics and feedback are deleted. Only teachers can perform this action. If the Prefer: include-unknown-enum-members request header is provided, the excused submission shows the excused status. Otherwise, the submission status retains the returned status. For more information about how to use this header, see the Examples section.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-excuse?view=graph-rest-1.0 + operationId: education.class.assignment.submission_excuse + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.reassign': + post: + tags: + - education.educationClass + summary: Invoke action reassign + description: 'Reassign the submission to the student with feedback for review. Only teachers can perform this action. Include the Prefer: include-unknown-enum-members header when you call this method; otherwise, a reassigned submission is treated as a returned submission. This means that the reassigned status is mapped to the returned status, and reassignedDateTime and reassignedBy properties are mapped to returnedDateTime and returnedBy respectively. If the header Prefer: include-unknown-enum-members is provided, a reassigned submission retains the reassigned status. For details, see the examples section.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-reassign?view=graph-rest-1.0 + operationId: education.class.assignment.submission_reassign + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.return': + post: + tags: + - education.educationClass + summary: Invoke action return + description: Make the grade and feedback associated with this submission available to the student. This action changes the status of the submission from 'submitted' to 'returned' and indicates that feedback is provided or grading is done. This action can only be done by the teacher. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-return?view=graph-rest-1.0 + operationId: education.class.assignment.submission_return + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.setUpResourcesFolder': + post: + tags: + - education.educationClass + summary: Invoke action setUpResourcesFolder + description: 'Trigger the creation of the SharePoint resource folder where all file-based resources (Word, Excel, and so on) should be uploaded for a given submission. Only teachers and students can perform this operation. Note that files must be located in this folder in order to be added as resources. Only a student in the class can determine what files to upload in a given submission-level resource folder. ' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-setupresourcesfolder?view=graph-rest-1.0 + operationId: education.class.assignment.submission_setUpResourcesFolder + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.submit': + post: + tags: + - education.educationClass + summary: Invoke action submit + description: 'Indicate that a student is done with the work and is ready to hand in the assignment. Only teachers, students, and applications with application permissions can perform this operation. This method changes the status of the submission from working to submitted. During the submit process, all the resources are copied to the submittedResources bucket. The teacher will be looking at the submitted resources list for grading. A teacher can also submit a student''s assignment on their behalf.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-submit?view=graph-rest-1.0 + operationId: education.class.assignment.submission_submit + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.unsubmit': + post: + tags: + - education.educationClass + summary: Invoke action unsubmit + description: 'Indicate that a student wants to work on the submission of the assignment after it was turned in. Only teachers, students, and applications with application permissions can perform this operation. This method changes the status of the submission from submitted to working. During the submit process, all the resources are copied from submittedResources to workingResources. The teacher will be looking at the working resources list for grading. A teacher can also unsubmit a student''s assignment on their behalf.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-unsubmit?view=graph-rest-1.0 + operationId: education.class.assignment.submission_unsubmit + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/outcomes': + get: + tags: + - education.educationClass + summary: List outcomes + description: 'Retrieve a list of educationOutcome objects. There are four types of outcomes: educationPointsOutcome, educationFeedbackOutcome, educationRubricOutcome, and educationFeedbackResourceOutcome. Only teachers, students, and applications with application permissions can perform this operation. A submission for a credit assignment (one that has no point value and no rubric) has an educationFeedbackOutcome. (It might also return an educationPointsOutcome, but that outcome is ignored.) A submission for a points assignment (one that has a point value assigned) has both an educationFeedbackOutcome and an educationPointsOutcome. A submission for an assignment with an attached rubric, if the rubric is a credit rubric (no points), has an educationFeedbackOutcome and an educationRubricOutcome. (It might also return an educationPointsOutcome, but that outcome is ignored.) A submission for an assignment with an attached rubric, if the rubric is a points rubric, has an educationFeedbackOutcome, an educationPointsOutcome, and an educationRubricOutcome. A submission for a feedback resource has an educationFeedbackResourceOutcome. All outcome types have a regular and a published property appropriate to that type of outcome; for example, points and publishedPoints, feedback and publishedFeedback. The regular property is the most recent value updated by the teacher; the published property is the most recent value returned to the student.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-list-outcomes?view=graph-rest-1.0 + operationId: education.class.assignment.submission_ListOutcome + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationOutcomeCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationClass + summary: Create educationFeedbackResourceOutcome + description: 'Create a new feedback resource for a submission. Only a teacher can perform this operation. To create a new file-based resource, upload the file to the feedback resources folder associated with the assignment. If the file doesn''t exist or isn''t in that folder, the POST request will fail.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationfeedbackresourceoutcome-post-outcomes?view=graph-rest-1.0 + operationId: education.class.assignment.submission_CreateOutcome + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationOutcome' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationOutcome' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/outcomes/{educationOutcome-id}': + get: + tags: + - education.educationClass + summary: Get outcomes from education + operationId: education.class.assignment.submission_GetOutcome + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationOutcome-id + in: path + description: The unique identifier of educationOutcome + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationOutcome + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationOutcome' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationClass + summary: Update educationOutcome + description: Update the properties of an educationOutcome object. Only teachers can perform this operation. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationoutcome-update?view=graph-rest-1.0 + operationId: education.class.assignment.submission_UpdateOutcome + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationOutcome-id + in: path + description: The unique identifier of educationOutcome + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationOutcome + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationOutcome' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationOutcome' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationClass + summary: Delete educationFeedbackResourceOutcome + description: Delete a feedback resource from a submission. This can only be done by a teacher. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationfeedbackresourceoutcome-delete?view=graph-rest-1.0 + operationId: education.class.assignment.submission_DeleteOutcome + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationOutcome-id + in: path + description: The unique identifier of educationOutcome + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationOutcome + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/outcomes/$count': + get: + tags: + - education.educationClass + summary: Get the number of the resource + operationId: education.class.assignment.submission.outcome_GetCount + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/resources': + get: + tags: + - education.educationClass + summary: List submission resources + description: 'List the resources associated with a submission. Only teachers, students, and applications with application permissions can perform this operation. The educationSubmissionResource object is a wrapper around the actual resource object the student is working on. The wrapper also includes a pointer to the resources on the assignment if this resource was copied from the assignment during the assign process. These resources are the working copy of the assignment. The submittedResources are the resources that were officially submitted for grading.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-list-resources?view=graph-rest-1.0 + operationId: education.class.assignment.submission_ListResource + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationSubmissionResourceCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationClass + summary: Create educationSubmissionResource + description: 'Add an educationSubmissionResource to a submission resource list. Only teachers and students can perform this operation. The operation will not succeed if the allowStudentsToAddResources flag is not set to true. To create a new file-based resource, upload the file to the resources folder associated with the submission. If the file doesn''t exist or is not in that folder, the POST request will fail.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-post-resources?view=graph-rest-1.0 + operationId: education.class.assignment.submission_CreateResource + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/resources/{educationSubmissionResource-id}': + get: + tags: + - education.educationClass + summary: Get educationSubmissionResource + description: 'Retrieve the properties of a specific resource associated with a submission. Only teachers, students, and applications with application permissions can perform this operation. This resource is in the ''working'' resource list and should be considered work in process by a student. This resource is wrapped with a possible pointer back to the assignment resource if it was copied from the assignment.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmissionresource-get?view=graph-rest-1.0 + operationId: education.class.assignment.submission_GetResource + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationSubmissionResource-id + in: path + description: The unique identifier of educationSubmissionResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmissionResource + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationClass + summary: Update the navigation property resources in education + operationId: education.class.assignment.submission_UpdateResource + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationSubmissionResource-id + in: path + description: The unique identifier of educationSubmissionResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmissionResource + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationClass + summary: Delete educationSubmissionResource + description: 'Delete an educationSubmissionResource from the submission. Only teachers and students can perform this operation. If the resource was copied from the assignment, a new copy of the resource will be created after the current copy is deleted. This allows you to ''reset'' the resource to its original state. If the resource wasn''t copied from the assignment but was added from the student, the resource is deleted.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmissionresource-delete?view=graph-rest-1.0 + operationId: education.class.assignment.submission_DeleteResource + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationSubmissionResource-id + in: path + description: The unique identifier of educationSubmissionResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmissionResource + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/resources/$count': + get: + tags: + - education.educationClass + summary: Get the number of the resource + operationId: education.class.assignment.submission.resource_GetCount + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/submittedResources': + get: + tags: + - education.educationClass + summary: List submittedResources + description: 'List the educationSubmissionResource objects that were officially submitted for grading. Only teachers, students, and applications with application permissions can perform this operation. The student who owns the submission can''t change the submitted list without resubmitting the assignment. This resource is a wrapper around the real resource and can contain a pointer back to the actual assignment resource if this resource was copied from the assignment.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-list-submittedresources?view=graph-rest-1.0 + operationId: education.class.assignment.submission_ListSubmittedResource + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationSubmissionResourceCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationClass + summary: Create new navigation property to submittedResources for education + operationId: education.class.assignment.submission_CreateSubmittedResource + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/submittedResources/{educationSubmissionResource-id}': + get: + tags: + - education.educationClass + summary: Get educationSubmittedSubmissionResource + description: 'Retrieve a submitted resource. Only teachers, students, and applications with application permissions can perform this operation. Resources are available to a teacher or an application with application permissions after a student submits it, and are available to the student after the teacher returns the submission. Teachers can leave notes in some resources.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmittedsubmissionresource-get?view=graph-rest-1.0 + operationId: education.class.assignment.submission_GetSubmittedResource + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationSubmissionResource-id + in: path + description: The unique identifier of educationSubmissionResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmissionResource + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationClass + summary: Update the navigation property submittedResources in education + operationId: education.class.assignment.submission_UpdateSubmittedResource + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationSubmissionResource-id + in: path + description: The unique identifier of educationSubmissionResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmissionResource + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationClass + summary: Delete navigation property submittedResources for education + operationId: education.class.assignment.submission_DeleteSubmittedResource + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationSubmissionResource-id + in: path + description: The unique identifier of educationSubmissionResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmissionResource + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/submittedResources/$count': + get: + tags: + - education.educationClass + summary: Get the number of the resource + operationId: education.class.assignment.submission.submittedResource_GetCount + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/submissions/$count': + get: + tags: + - education.educationClass + summary: Get the number of the resource + operationId: education.class.assignment.submission_GetCount + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/classes/{educationClass-id}/assignments/$count': + get: + tags: + - education.educationClass + summary: Get the number of the resource + operationId: education.class.assignment_GetCount + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/classes/{educationClass-id}/assignments/microsoft.graph.delta()': + get: + tags: + - education.educationClass + summary: Invoke function delta + description: Get a list of newly-created or updated assignments without reading the whole collection. A teacher or an application running with application permissions can see all assignment objects for the class. Students can only see assignments that are assigned to them. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-delta?view=graph-rest-1.0 + operationId: education.class.assignment_delta + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Success + content: + application/json: + schema: + title: Collection of educationAssignment + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + '@odata.nextLink': + type: string + nullable: true + '@odata.deltaLink': + type: string + nullable: true + additionalProperties: + type: object + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: function + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + '/education/classes/{educationClass-id}/assignmentSettings': + get: + tags: + - education.educationClass + summary: Get assignmentSettings from education + description: Specifies class-level assignments settings. + operationId: education.class_GetAssignmentSetting + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignmentSettings' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationClass + summary: Update educationAssignmentSettings + description: Update the properties of an educationAssignmentSettings object. Only teachers can update these settings. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignmentsettings-update?view=graph-rest-1.0 + operationId: education.class_UpdateAssignmentSetting + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignmentSettings' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignmentSettings' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationClass + summary: Delete navigation property assignmentSettings for education + operationId: education.class_DeleteAssignmentSetting + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignmentSettings/gradingCategories': + get: + tags: + - education.educationClass + summary: Get gradingCategories from education + description: 'When set, enables users to weight assignments differently when computing a class average grade.' + operationId: education.class.assignmentSetting_ListGradingCategory + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationGradingCategoryCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationClass + summary: Create new navigation property to gradingCategories for education + operationId: education.class.assignmentSetting_CreateGradingCategory + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationGradingCategory' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationGradingCategory' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignmentSettings/gradingCategories/{educationGradingCategory-id}': + get: + tags: + - education.educationClass + summary: Get gradingCategories from education + description: 'When set, enables users to weight assignments differently when computing a class average grade.' + operationId: education.class.assignmentSetting_GetGradingCategory + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationGradingCategory-id + in: path + description: The unique identifier of educationGradingCategory + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationGradingCategory + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationGradingCategory' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationClass + summary: Update gradingCategory + description: Update a single gradingCategory on the educationAssignmentSettings. Only teachers can perform this operation. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationgradingcategory-update?view=graph-rest-1.0 + operationId: education.class.assignmentSetting_UpdateGradingCategory + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationGradingCategory-id + in: path + description: The unique identifier of educationGradingCategory + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationGradingCategory + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationGradingCategory' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationGradingCategory' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationClass + summary: Delete navigation property gradingCategories for education + operationId: education.class.assignmentSetting_DeleteGradingCategory + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationGradingCategory-id + in: path + description: The unique identifier of educationGradingCategory + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationGradingCategory + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/assignmentSettings/gradingCategories/$count': + get: + tags: + - education.educationClass + summary: Get the number of the resource + operationId: education.class.assignmentSetting.gradingCategory_GetCount + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/classes/{educationClass-id}/group': + get: + tags: + - education.educationClass + summary: Get group from education + description: The underlying Microsoft 365 group object. + operationId: education.class_GetGroup + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.group' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/group/serviceProvisioningErrors': + get: + tags: + - education.educationClass + summary: Get serviceProvisioningErrors property value + description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a group object. Supports $filter (eq, not, for isResolved and serviceInstance).' + operationId: education.class.group_ListServiceProvisioningError + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + '/education/classes/{educationClass-id}/group/serviceProvisioningErrors/$count': + get: + tags: + - education.educationClass + summary: Get the number of the resource + operationId: education.class.group.ServiceProvisioningError_GetCount + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/classes/{educationClass-id}/members': + get: + tags: + - education.educationClass + summary: List members of an educationClass + description: Retrieves the educationUser members of an educationClass. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-list-members?view=graph-rest-1.0 + operationId: education.class_ListMember + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationUserCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/members/{educationUser-id}/$ref': + delete: + tags: + - education.educationClass + summary: Remove member from educationClass + description: Remove an educationUser from an educationClass. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-delete-members?view=graph-rest-1.0 + operationId: education.class.member_DeleteEducationUserGraphBPreRef + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/members/$count': + get: + tags: + - education.educationClass + summary: Get the number of the resource + operationId: education.class.member_GetCount + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/classes/{educationClass-id}/members/$ref': + get: + tags: + - education.educationClass + summary: List members of an educationClass + description: Retrieves the educationUser members of an educationClass. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-list-members?view=graph-rest-1.0 + operationId: education.class_ListMemberGraphBPreRef + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/StringCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationClass + summary: Add a student + description: Add an educationUser member to an educationClass. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-post-members?view=graph-rest-1.0 + operationId: education.class_CreateMemberGraphBPreRef + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + requestBody: + $ref: '#/components/requestBodies/refPostBody' + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationClass + summary: Remove member from educationClass + description: Remove an educationUser from an educationClass. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-delete-members?view=graph-rest-1.0 + operationId: education.class_DeleteMemberGraphBPreRef + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + - name: '@id' + in: query + description: The delete Uri + required: true + style: form + explode: false + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/modules': + get: + tags: + - education.educationClass + summary: List class modules + description: 'Retrieve a list of module objects. Only teachers, students, and applications with application permissions can perform this operation. A teacher or an application with application permissions can see all module objects for the class. Students can only see published modules.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-list-modules?view=graph-rest-1.0 + operationId: education.class_ListModule + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationModuleCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationClass + summary: Create educationModule + description: 'Create a new module in a class. Only teachers in a class can create a module. Modules start in the draft state, which means that students can''t see the modules until publication.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-post-module?view=graph-rest-1.0 + operationId: education.class_CreateModule + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationModule' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationModule' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/modules/{educationModule-id}': + get: + tags: + - education.educationClass + summary: Get educationModule + description: 'Get the properties and relationships of a module. Only teachers, students, and applications with application permissions can perform this operation. Students can only see published modules; teachers and applications with application permissions can see all modules in a class.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationmodule-get?view=graph-rest-1.0 + operationId: education.class_GetModule + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationModule-id + in: path + description: The unique identifier of educationModule + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationModule + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationModule' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationClass + summary: Update educationModule + description: Update an educationModule object in a class. Only teachers in the class can perform this operation. You can't use a PATCH request to change the status of a module. Use the publish action to change the module status. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationmodule-update?view=graph-rest-1.0 + operationId: education.class_UpdateModule + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationModule-id + in: path + description: The unique identifier of educationModule + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationModule + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationModule' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationModule' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationClass + summary: Delete educationModule + description: Delete an existing module in a class. Only teachers within a class can delete modules. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationmodule-delete?view=graph-rest-1.0 + operationId: education.class_DeleteModule + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationModule-id + in: path + description: The unique identifier of educationModule + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationModule + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/modules/{educationModule-id}/microsoft.graph.pin': + post: + tags: + - education.educationClass + summary: Invoke action pin + description: Pin an educationModule in the class work list. This action sets the isPinned property to true for an educationModule. Only teachers can perform this action and only one module at a time can be pinned in the class work list. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationmodule-pin?view=graph-rest-1.0 + operationId: education.class.module_pin + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationModule-id + in: path + description: The unique identifier of educationModule + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationModule + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationModule' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/classes/{educationClass-id}/modules/{educationModule-id}/microsoft.graph.publish': + post: + tags: + - education.educationClass + summary: Invoke action publish + description: 'Change the state of an educationModule from its original draft status to the published status. Only teachers in the class can perform this operation. When a module is in draft status, students can''t see the module. When you call this API, the module appears in the student''s class work list.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationmodule-publish?view=graph-rest-1.0 + operationId: education.class.module_publish + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationModule-id + in: path + description: The unique identifier of educationModule + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationModule + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationModule' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/classes/{educationClass-id}/modules/{educationModule-id}/microsoft.graph.setUpResourcesFolder': + post: + tags: + - education.educationClass + summary: Invoke action setUpResourcesFolder + description: Create a SharePoint folder to upload files for a given educationModule. Only teachers can perform this operation. The teacher determines what resources to upload to the SharePoint folder for the module. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationmodule-setupresourcesfolder?view=graph-rest-1.0 + operationId: education.class.module_setUpResourcesFolder + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationModule-id + in: path + description: The unique identifier of educationModule + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationModule + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationModule' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/classes/{educationClass-id}/modules/{educationModule-id}/microsoft.graph.unpin': + post: + tags: + - education.educationClass + summary: Invoke action unpin + description: Unpin an educationModule in the classwork list. This action sets the isPinned property to false for an educationModule. Only teachers in the class can perform this operation. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationmodule-unpin?view=graph-rest-1.0 + operationId: education.class.module_unpin + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationModule-id + in: path + description: The unique identifier of educationModule + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationModule + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationModule' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/classes/{educationClass-id}/modules/{educationModule-id}/resources': + get: + tags: + - education.educationClass + summary: List module resources + description: 'Get all the educationModuleResource objects associated with a module. Only teachers, students, and applications with application permissions can perform this operation.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationmodule-list-resources?view=graph-rest-1.0 + operationId: education.class.module_ListResource + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationModule-id + in: path + description: The unique identifier of educationModule + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationModule + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationModuleResourceCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationClass + summary: Create educationModuleResource + description: 'Create a resource in a module. Only teachers can perform this operation. You can create the following types of module resources: Every resource has an @odata.type property to indicate which type of resource is being created.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationmodule-post-resources?view=graph-rest-1.0 + operationId: education.class.module_CreateResource + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationModule-id + in: path + description: The unique identifier of educationModule + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationModule + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationModuleResource' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationModuleResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/modules/{educationModule-id}/resources/{educationModuleResource-id}': + get: + tags: + - education.educationClass + summary: Get educationModuleResource + description: 'Get the properties of a resource associated with a module. Only teachers, students, and applications with application permissions can perform this operation.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationmoduleresource-get?view=graph-rest-1.0 + operationId: education.class.module_GetResource + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationModule-id + in: path + description: The unique identifier of educationModule + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationModule + - name: educationModuleResource-id + in: path + description: The unique identifier of educationModuleResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationModuleResource + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationModuleResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationClass + summary: Update educationModuleResource + description: 'Update a resource in a module. Only teachers can perform this operation. The only one property that can be updated is displayName, for all resource types.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationmoduleresource-update?view=graph-rest-1.0 + operationId: education.class.module_UpdateResource + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationModule-id + in: path + description: The unique identifier of educationModule + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationModule + - name: educationModuleResource-id + in: path + description: The unique identifier of educationModuleResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationModuleResource + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationModuleResource' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationModuleResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationClass + summary: Delete educationModuleResource + description: Delete a specific educationModuleResource attached to a module. Only teachers in the class can remove a resource. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationmoduleresource-delete?view=graph-rest-1.0 + operationId: education.class.module_DeleteResource + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationModule-id + in: path + description: The unique identifier of educationModule + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationModule + - name: educationModuleResource-id + in: path + description: The unique identifier of educationModuleResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationModuleResource + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/modules/{educationModule-id}/resources/$count': + get: + tags: + - education.educationClass + summary: Get the number of the resource + operationId: education.class.module.resource_GetCount + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationModule-id + in: path + description: The unique identifier of educationModule + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationModule + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/classes/{educationClass-id}/modules/$count': + get: + tags: + - education.educationClass + summary: Get the number of the resource + operationId: education.class.module_GetCount + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/classes/{educationClass-id}/schools': + get: + tags: + - education.educationClass + summary: List schools + description: Retrieve a list of schools in which the class is taught. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-list-schools?view=graph-rest-1.0 + operationId: education.class_ListSchool + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationSchoolCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/schools/{educationSchool-id}': + get: + tags: + - education.educationClass + summary: Get schools from education + description: All schools that this class is associated with. Nullable. + operationId: education.class_GetSchool + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationSchool-id + in: path + description: The unique identifier of educationSchool + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSchool + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSchool' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/schools/$count': + get: + tags: + - education.educationClass + summary: Get the number of the resource + operationId: education.class.school_GetCount + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/classes/{educationClass-id}/teachers': + get: + tags: + - education.educationClass + summary: List teachers + description: Retrieve a list of teachers for a class. Delegated tokens must be members of the class to get the teacher list. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-list-teachers?view=graph-rest-1.0 + operationId: education.class_ListTeacher + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationUserCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/teachers/{educationUser-id}/$ref': + delete: + tags: + - education.educationClass + summary: Remove teacher from educationClass + description: Remove a teacher from an educationClass. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-delete-teachers?view=graph-rest-1.0 + operationId: education.class.teacher_DeleteEducationUserGraphBPreRef + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/classes/{educationClass-id}/teachers/$count': + get: + tags: + - education.educationClass + summary: Get the number of the resource + operationId: education.class.teacher_GetCount + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/classes/{educationClass-id}/teachers/$ref': + get: + tags: + - education.educationClass + summary: List teachers + description: Retrieve a list of teachers for a class. Delegated tokens must be members of the class to get the teacher list. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-list-teachers?view=graph-rest-1.0 + operationId: education.class_ListTeacherGraphBPreRef + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/StringCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationClass + summary: Add teacher + description: Add a teacher to a class. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-post-teachers?view=graph-rest-1.0 + operationId: education.class_CreateTeacherGraphBPreRef + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + requestBody: + $ref: '#/components/requestBodies/refPostBody' + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationClass + summary: Remove teacher from educationClass + description: Remove a teacher from an educationClass. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-delete-teachers?view=graph-rest-1.0 + operationId: education.class_DeleteTeacherGraphBPreRef + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + - name: '@id' + in: query + description: The delete Uri + required: true + style: form + explode: false + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + /education/classes/$count: + get: + tags: + - education.educationClass + summary: Get the number of the resource + operationId: education.class_GetCount + parameters: + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + /education/classes/microsoft.graph.delta(): + get: + tags: + - education.educationClass + summary: Invoke function delta + description: 'Get newly created or updated classes, including membership changes, without having to perform a full read of the entire class collection. See Use delta query for details.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationclass-delta?view=graph-rest-1.0 + operationId: education.class_delta + parameters: + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Success + content: + application/json: + schema: + title: Collection of educationClass + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.educationClass' + '@odata.nextLink': + type: string + nullable: true + '@odata.deltaLink': + type: string + nullable: true + additionalProperties: + type: object + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: function + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + /education/me: + get: + tags: + - education.educationUser + summary: Get me from education + operationId: education_GetMe + parameters: + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationUser' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationUser + summary: Update the navigation property me in education + operationId: education_UpdateMe + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationUser' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationUser' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete navigation property me for education + operationId: education_DeleteMe + parameters: + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + /education/me/assignments: + get: + tags: + - education.educationUser + summary: List assignments of a user + description: 'Returns a list of educationAssignment assigned to a educationUser for all classes. Only teachers, students, and applications with application permissions can perform this operation. This method allows a caller to find all the assignments belonging to a student or a teacher in a single call rather than having to request assignments from each class. The assignment list contains what is needed to get the detailed information for the assignment from within the class namespace. Use the methods defined for the assignment for all other operations.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationuser-list-assignments?view=graph-rest-1.0 + operationId: education.me_ListAssignment + parameters: + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationAssignmentCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationUser + summary: Create new navigation property to assignments for education + operationId: education.me_CreateAssignment + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/me/assignments/{educationAssignment-id}': + get: + tags: + - education.educationUser + summary: Get assignments from education + description: Assignments belonging to the user. + operationId: education.me_GetAssignment + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationUser + summary: Update the navigation property assignments in education + operationId: education.me_UpdateAssignment + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete navigation property assignments for education + operationId: education.me_DeleteAssignment + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/me/assignments/{educationAssignment-id}/categories': + get: + tags: + - education.educationUser + summary: Get categories from education + description: 'When set, enables users to easily find assignments of a given type. Read-only. Nullable.' + operationId: education.me.assignment_ListCategory + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationCategoryCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationUser + summary: Create new navigation property to categories for education + operationId: education.me.assignment_CreateCategory + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationCategory' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationCategory' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/me/assignments/{educationAssignment-id}/categories/{educationCategory-id}/$ref': + delete: + tags: + - education.educationUser + summary: Delete ref of navigation property categories for education + operationId: education.me.assignment.category_DeleteEducationCategoryGraphBPreRef + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationCategory-id + in: path + description: The unique identifier of educationCategory + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationCategory + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/me/assignments/{educationAssignment-id}/categories/$count': + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.me.assignment.category_GetCount + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/me/assignments/{educationAssignment-id}/categories/$ref': + get: + tags: + - education.educationUser + summary: Get ref of categories from education + description: 'When set, enables users to easily find assignments of a given type. Read-only. Nullable.' + operationId: education.me.assignment_ListCategoryGraphBPreRef + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/StringCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationUser + summary: Create new navigation property ref to categories for education + operationId: education.me.assignment_CreateCategoryGraphBPreRef + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + requestBody: + $ref: '#/components/requestBodies/refPostBody' + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete ref of navigation property categories for education + operationId: education.me.assignment_DeleteCategoryGraphBPreRef + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + - name: '@id' + in: query + description: The delete Uri + required: true + style: form + explode: false + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/me/assignments/{educationAssignment-id}/categories/microsoft.graph.delta()': + get: + tags: + - education.educationUser + summary: Invoke function delta + description: Get a list of newly created or updated educationCategory objects without having to perform a full read of the collection. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationcategory-delta?view=graph-rest-1.0 + operationId: education.me.assignment.category_delta + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Success + content: + application/json: + schema: + title: Collection of educationCategory + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.educationCategory' + '@odata.nextLink': + type: string + nullable: true + '@odata.deltaLink': + type: string + nullable: true + additionalProperties: + type: object + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: function + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + '/education/me/assignments/{educationAssignment-id}/gradingCategory': + get: + tags: + - education.educationUser + summary: Get gradingCategory from education + description: 'When set, enables users to weight assignments differently when computing a class average grade.' + operationId: education.me.assignment_GetGradingCategory + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationGradingCategory' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/me/assignments/{educationAssignment-id}/microsoft.graph.activate': + post: + tags: + - education.educationUser + summary: Invoke action activate + description: Activate an inactive educationAssignment to signal that the assignment has further action items for teachers or students. This action can only be performed by a teacher on currently inactive assignments. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-activate?view=graph-rest-1.0 + operationId: education.me.assignment_activate + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/me/assignments/{educationAssignment-id}/microsoft.graph.deactivate': + post: + tags: + - education.educationUser + summary: Invoke action deactivate + description: Mark an assigned educationAssignment as inactive to signal that the assignment has no further action items for teachers and students. This action can only be performed by a teacher on assigned assignments. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-deactivate?view=graph-rest-1.0 + operationId: education.me.assignment_deactivate + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/me/assignments/{educationAssignment-id}/microsoft.graph.publish': + post: + tags: + - education.educationUser + summary: Invoke action publish + description: 'Publish an education assignment. Change the status of an educationAssignment from its original draft status to the published status. You can change the status from draft to scheduled if the assignment is scheduled for a future date. Only a teacher in the class can make this call. When an assignment is in draft status, students will not see the assignment, nor will there be any submission objects. Calling this API creates educationSubmission objects and displays the assignment in each student''s list. The status of the assignment goes back to draft if there is any backend failure during publish process. To update the properties of a published assignment, see update an assignment.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-publish?view=graph-rest-1.0 + operationId: education.me.assignment_publish + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/me/assignments/{educationAssignment-id}/microsoft.graph.setUpFeedbackResourcesFolder': + post: + tags: + - education.educationUser + summary: Invoke action setUpFeedbackResourcesFolder + description: Create a SharePoint folder to upload feedback files for a given educationSubmission. Only teachers can perform this operation. The teacher determines the resources to upload in the feedback resources folder of a submission. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-setupfeedbackresourcesfolder?view=graph-rest-1.0 + operationId: education.me.assignment_setUpFeedbackResourcesFolder + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/me/assignments/{educationAssignment-id}/microsoft.graph.setUpResourcesFolder': + post: + tags: + - education.educationUser + summary: Invoke action setUpResourcesFolder + description: 'Create a SharePoint folder to upload files for a given educationAssignment. Only teachers can perform this operation. The teacher determines the resources to upload in the assignment''s folder. ' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-setupresourcesfolder?view=graph-rest-1.0 + operationId: education.me.assignment_setUpResourcesFolder + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/me/assignments/{educationAssignment-id}/resources': + get: + tags: + - education.educationUser + summary: Get resources from education + description: Learning objects that are associated with this assignment. Only teachers can modify this list. Nullable. + operationId: education.me.assignment_ListResource + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationAssignmentResourceCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationUser + summary: Create new navigation property to resources for education + operationId: education.me.assignment_CreateResource + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/me/assignments/{educationAssignment-id}/resources/{educationAssignmentResource-id}': + get: + tags: + - education.educationUser + summary: Get resources from education + description: Learning objects that are associated with this assignment. Only teachers can modify this list. Nullable. + operationId: education.me.assignment_GetResource + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationAssignmentResource-id + in: path + description: The unique identifier of educationAssignmentResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignmentResource + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationUser + summary: Update the navigation property resources in education + operationId: education.me.assignment_UpdateResource + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationAssignmentResource-id + in: path + description: The unique identifier of educationAssignmentResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignmentResource + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete navigation property resources for education + operationId: education.me.assignment_DeleteResource + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationAssignmentResource-id + in: path + description: The unique identifier of educationAssignmentResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignmentResource + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/me/assignments/{educationAssignment-id}/resources/$count': + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.me.assignment.resource_GetCount + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/me/assignments/{educationAssignment-id}/rubric': + get: + tags: + - education.educationUser + summary: Get rubric from education + description: 'When set, the grading rubric attached to this assignment.' + operationId: education.me.assignment_GetRubric + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRubric' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationUser + summary: Update the navigation property rubric in education + operationId: education.me.assignment_UpdateRubric + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRubric' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRubric' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete navigation property rubric for education + operationId: education.me.assignment_DeleteRubric + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/me/assignments/{educationAssignment-id}/rubric/$ref': + get: + tags: + - education.educationUser + summary: Get ref of rubric from education + description: 'When set, the grading rubric attached to this assignment.' + operationId: education.me.assignment_GetRubricGraphBPreRef + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + responses: + 2XX: + description: Retrieved navigation property link + content: + application/json: + schema: + type: string + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + put: + tags: + - education.educationUser + summary: Update the ref of navigation property rubric in education + operationId: education.me.assignment_SetRubricGraphBPreRef + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + requestBody: + $ref: '#/components/requestBodies/refPutBody' + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete ref of navigation property rubric for education + operationId: education.me.assignment_DeleteRubricGraphBPreRef + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/me/assignments/{educationAssignment-id}/submissions': + get: + tags: + - education.educationUser + summary: Get submissions from education + description: 'Once published, there''s a submission object for each student representing their work and grade. Read-only. Nullable.' + operationId: education.me.assignment_ListSubmission + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationSubmissionCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationUser + summary: Create new navigation property to submissions for education + operationId: education.me.assignment_CreateSubmission + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}': + get: + tags: + - education.educationUser + summary: Get submissions from education + description: 'Once published, there''s a submission object for each student representing their work and grade. Read-only. Nullable.' + operationId: education.me.assignment_GetSubmission + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationUser + summary: Update the navigation property submissions in education + operationId: education.me.assignment_UpdateSubmission + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete navigation property submissions for education + operationId: education.me.assignment_DeleteSubmission + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.excuse': + post: + tags: + - education.educationUser + summary: Invoke action excuse + description: 'Excuse a submission. Excused submissions aren''t included in average grade calculations. Grading rubrics and feedback are deleted. Only teachers can perform this action. If the Prefer: include-unknown-enum-members request header is provided, the excused submission shows the excused status. Otherwise, the submission status retains the returned status. For more information about how to use this header, see the Examples section.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-excuse?view=graph-rest-1.0 + operationId: education.me.assignment.submission_excuse + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.reassign': + post: + tags: + - education.educationUser + summary: Invoke action reassign + description: 'Reassign the submission to the student with feedback for review. Only teachers can perform this action. Include the Prefer: include-unknown-enum-members header when you call this method; otherwise, a reassigned submission is treated as a returned submission. This means that the reassigned status is mapped to the returned status, and reassignedDateTime and reassignedBy properties are mapped to returnedDateTime and returnedBy respectively. If the header Prefer: include-unknown-enum-members is provided, a reassigned submission retains the reassigned status. For details, see the examples section.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-reassign?view=graph-rest-1.0 + operationId: education.me.assignment.submission_reassign + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.return': + post: + tags: + - education.educationUser + summary: Invoke action return + description: Make the grade and feedback associated with this submission available to the student. This action changes the status of the submission from 'submitted' to 'returned' and indicates that feedback is provided or grading is done. This action can only be done by the teacher. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-return?view=graph-rest-1.0 + operationId: education.me.assignment.submission_return + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.setUpResourcesFolder': + post: + tags: + - education.educationUser + summary: Invoke action setUpResourcesFolder + description: 'Trigger the creation of the SharePoint resource folder where all file-based resources (Word, Excel, and so on) should be uploaded for a given submission. Only teachers and students can perform this operation. Note that files must be located in this folder in order to be added as resources. Only a student in the class can determine what files to upload in a given submission-level resource folder. ' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-setupresourcesfolder?view=graph-rest-1.0 + operationId: education.me.assignment.submission_setUpResourcesFolder + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.submit': + post: + tags: + - education.educationUser + summary: Invoke action submit + description: 'Indicate that a student is done with the work and is ready to hand in the assignment. Only teachers, students, and applications with application permissions can perform this operation. This method changes the status of the submission from working to submitted. During the submit process, all the resources are copied to the submittedResources bucket. The teacher will be looking at the submitted resources list for grading. A teacher can also submit a student''s assignment on their behalf.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-submit?view=graph-rest-1.0 + operationId: education.me.assignment.submission_submit + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.unsubmit': + post: + tags: + - education.educationUser + summary: Invoke action unsubmit + description: 'Indicate that a student wants to work on the submission of the assignment after it was turned in. Only teachers, students, and applications with application permissions can perform this operation. This method changes the status of the submission from submitted to working. During the submit process, all the resources are copied from submittedResources to workingResources. The teacher will be looking at the working resources list for grading. A teacher can also unsubmit a student''s assignment on their behalf.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-unsubmit?view=graph-rest-1.0 + operationId: education.me.assignment.submission_unsubmit + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/outcomes': + get: + tags: + - education.educationUser + summary: Get outcomes from education + operationId: education.me.assignment.submission_ListOutcome + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationOutcomeCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationUser + summary: Create new navigation property to outcomes for education + operationId: education.me.assignment.submission_CreateOutcome + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationOutcome' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationOutcome' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/outcomes/{educationOutcome-id}': + get: + tags: + - education.educationUser + summary: Get outcomes from education + operationId: education.me.assignment.submission_GetOutcome + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationOutcome-id + in: path + description: The unique identifier of educationOutcome + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationOutcome + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationOutcome' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationUser + summary: Update the navigation property outcomes in education + operationId: education.me.assignment.submission_UpdateOutcome + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationOutcome-id + in: path + description: The unique identifier of educationOutcome + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationOutcome + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationOutcome' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationOutcome' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete navigation property outcomes for education + operationId: education.me.assignment.submission_DeleteOutcome + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationOutcome-id + in: path + description: The unique identifier of educationOutcome + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationOutcome + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/outcomes/$count': + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.me.assignment.submission.outcome_GetCount + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/resources': + get: + tags: + - education.educationUser + summary: Get resources from education + operationId: education.me.assignment.submission_ListResource + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationSubmissionResourceCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationUser + summary: Create new navigation property to resources for education + operationId: education.me.assignment.submission_CreateResource + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/resources/{educationSubmissionResource-id}': + get: + tags: + - education.educationUser + summary: Get resources from education + operationId: education.me.assignment.submission_GetResource + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationSubmissionResource-id + in: path + description: The unique identifier of educationSubmissionResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmissionResource + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationUser + summary: Update the navigation property resources in education + operationId: education.me.assignment.submission_UpdateResource + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationSubmissionResource-id + in: path + description: The unique identifier of educationSubmissionResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmissionResource + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete navigation property resources for education + operationId: education.me.assignment.submission_DeleteResource + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationSubmissionResource-id + in: path + description: The unique identifier of educationSubmissionResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmissionResource + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/resources/$count': + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.me.assignment.submission.resource_GetCount + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/submittedResources': + get: + tags: + - education.educationUser + summary: Get submittedResources from education + operationId: education.me.assignment.submission_ListSubmittedResource + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationSubmissionResourceCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationUser + summary: Create new navigation property to submittedResources for education + operationId: education.me.assignment.submission_CreateSubmittedResource + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/submittedResources/{educationSubmissionResource-id}': + get: + tags: + - education.educationUser + summary: Get submittedResources from education + operationId: education.me.assignment.submission_GetSubmittedResource + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationSubmissionResource-id + in: path + description: The unique identifier of educationSubmissionResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmissionResource + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationUser + summary: Update the navigation property submittedResources in education + operationId: education.me.assignment.submission_UpdateSubmittedResource + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationSubmissionResource-id + in: path + description: The unique identifier of educationSubmissionResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmissionResource + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete navigation property submittedResources for education + operationId: education.me.assignment.submission_DeleteSubmittedResource + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationSubmissionResource-id + in: path + description: The unique identifier of educationSubmissionResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmissionResource + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/me/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/submittedResources/$count': + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.me.assignment.submission.submittedResource_GetCount + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/me/assignments/{educationAssignment-id}/submissions/$count': + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.me.assignment.submission_GetCount + parameters: + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + /education/me/assignments/$count: + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.me.assignment_GetCount + parameters: + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + /education/me/assignments/microsoft.graph.delta(): + get: + tags: + - education.educationUser + summary: Invoke function delta + description: Get a list of newly-created or updated assignments without reading the whole collection. A teacher or an application running with application permissions can see all assignment objects for the class. Students can only see assignments that are assigned to them. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-delta?view=graph-rest-1.0 + operationId: education.me.assignment_delta + parameters: + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Success + content: + application/json: + schema: + title: Collection of educationAssignment + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + '@odata.nextLink': + type: string + nullable: true + '@odata.deltaLink': + type: string + nullable: true + additionalProperties: + type: object + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: function + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + /education/me/classes: + get: + tags: + - education.educationUser + summary: List classes of an educationUser + description: Get the educationClass resources an educationUser is a member of. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationuser-list-classes?view=graph-rest-1.0 + operationId: education.me_ListClass + parameters: + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationClassCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + '/education/me/classes/{educationClass-id}': + get: + tags: + - education.educationUser + summary: Get classes from education + description: Classes to which the user belongs. Nullable. + operationId: education.me_GetClass + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationClass' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + /education/me/classes/$count: + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.me.class_GetCount + parameters: + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + /education/me/rubrics: + get: + tags: + - education.educationUser + summary: List rubrics + description: Retrieve a list of educationRubric objects. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationuser-list-rubrics?view=graph-rest-1.0 + operationId: education.me_ListRubric + parameters: + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationRubricCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationUser + summary: Create educationRubric + description: Create a new educationRubric object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationuser-post-rubrics?view=graph-rest-1.0 + operationId: education.me_CreateRubric + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRubric' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRubric' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/me/rubrics/{educationRubric-id}': + get: + tags: + - education.educationUser + summary: Get educationRubric + description: Retrieve the properties and relationships of an educationRubric object. Only teachers and students can perform this operation. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationrubric-get?view=graph-rest-1.0 + operationId: education.me_GetRubric + parameters: + - name: educationRubric-id + in: path + description: The unique identifier of educationRubric + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationRubric + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRubric' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationUser + summary: Update educationRubric + description: 'Update the properties of an educationRubric object. Only teachers can perform this operation. Updating a rubric attached to an assignment (PATCH /education/classes/{class-id}/assignments/{assignment-id}/rubric) is only possible before the assignment is published, and what is updated is actually the original rubric that exists under /education/users/{id}/rubrics. After the assignment is published, an immutable copy of the rubric is made that is attached to that specific assignment. That rubric can be retrieved using GET /education/classes/{class-id}/assignments/{assignment-id}/rubric, but it can''t be updated.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationrubric-update?view=graph-rest-1.0 + operationId: education.me_UpdateRubric + parameters: + - name: educationRubric-id + in: path + description: The unique identifier of educationRubric + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationRubric + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRubric' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRubric' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete educationRubric + description: Delete an educationRubric object. Only teachers can perform this operation. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationrubric-delete?view=graph-rest-1.0 + operationId: education.me_DeleteRubric + parameters: + - name: educationRubric-id + in: path + description: The unique identifier of educationRubric + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationRubric + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + /education/me/rubrics/$count: + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.me.rubric_GetCount + parameters: + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + /education/me/schools: + get: + tags: + - education.educationUser + summary: List schools of an educationUser + description: Retrieve a list of schools for a user. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationuser-list-schools?view=graph-rest-1.0 + operationId: education.me_ListSchool + parameters: + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationSchoolCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + '/education/me/schools/{educationSchool-id}': + get: + tags: + - education.educationUser + summary: Get schools from education + description: Schools to which the user belongs. Nullable. + operationId: education.me_GetSchool + parameters: + - name: educationSchool-id + in: path + description: The unique identifier of educationSchool + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSchool + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSchool' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + /education/me/schools/$count: + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.me.school_GetCount + parameters: + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + /education/me/taughtClasses: + get: + tags: + - education.educationUser + summary: Get taughtClasses from education + description: Classes for which the user is a teacher. + operationId: education.me_ListTaughtClass + parameters: + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationClassCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + '/education/me/taughtClasses/{educationClass-id}': + get: + tags: + - education.educationUser + summary: Get taughtClasses from education + description: Classes for which the user is a teacher. + operationId: education.me_GetTaughtClass + parameters: + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationClass' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + /education/me/taughtClasses/$count: + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.me.taughtClass_GetCount + parameters: + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + /education/me/user: + get: + tags: + - education.educationUser + summary: Get educationUser + description: Retrieve the simple directory user that corresponds to this educationUser. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationuser-get-user?view=graph-rest-1.0 + operationId: education.me_GetUser + parameters: + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.user' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + /education/me/user/mailboxSettings: + get: + tags: + - education.educationUser + summary: Get mailboxSettings property value + description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Returned only on $select.' + operationId: education.me.user_GetMailboxSetting + parameters: + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Entity result. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.mailboxSettings' + default: + $ref: '#/components/responses/error' + patch: + tags: + - education.educationUser + summary: Update property mailboxSettings value. + operationId: education.me.user_UpdateMailboxSetting + requestBody: + description: New property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.mailboxSettings' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.mailboxSettings' + default: + $ref: '#/components/responses/error' + /education/me/user/serviceProvisioningErrors: + get: + tags: + - education.educationUser + summary: Get serviceProvisioningErrors property value + description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).' + operationId: education.me.user_ListServiceProvisioningError + parameters: + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + /education/me/user/serviceProvisioningErrors/$count: + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.me.user.ServiceProvisioningError_GetCount + parameters: + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + /education/schools: + get: + tags: + - education.educationSchool + summary: List educationSchools + description: Get a list of the educationSchool objects and their properties. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationschool-list?view=graph-rest-1.0 + operationId: education_ListSchool + parameters: + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationSchoolCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationSchool + summary: Create educationSchool + description: Create a new educationSchool object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationschool-post?view=graph-rest-1.0 + operationId: education_CreateSchool + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSchool' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSchool' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/schools/{educationSchool-id}': + get: + tags: + - education.educationSchool + summary: Get educationSchool + description: Read the properties and relationships of an educationSchool object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationschool-get?view=graph-rest-1.0 + operationId: education_GetSchool + parameters: + - name: educationSchool-id + in: path + description: The unique identifier of educationSchool + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSchool + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSchool' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationSchool + summary: Update educationSchool + description: Update the properties of an educationSchool object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationschool-update?view=graph-rest-1.0 + operationId: education_UpdateSchool + parameters: + - name: educationSchool-id + in: path + description: The unique identifier of educationSchool + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSchool + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSchool' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSchool' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationSchool + summary: Delete educationSchool + description: Delete a school. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationschool-delete?view=graph-rest-1.0 + operationId: education_DeleteSchool + parameters: + - name: educationSchool-id + in: path + description: The unique identifier of educationSchool + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSchool + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/schools/{educationSchool-id}/administrativeUnit': + get: + tags: + - education.educationSchool + summary: Get administrativeUnit from education + description: The underlying administrativeUnit for this school. + operationId: education.school_GetAdministrativeUnit + parameters: + - name: educationSchool-id + in: path + description: The unique identifier of educationSchool + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSchool + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.administrativeUnit' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationSchool + summary: Update the navigation property administrativeUnit in education + operationId: education.school_UpdateAdministrativeUnit + parameters: + - name: educationSchool-id + in: path + description: The unique identifier of educationSchool + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSchool + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.administrativeUnit' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.administrativeUnit' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/schools/{educationSchool-id}/classes': + get: + tags: + - education.educationSchool + summary: List classes of an educationSchool + description: Get the educationClass resources owned by an educationSchool. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationschool-list-classes?view=graph-rest-1.0 + operationId: education.school_ListClass + parameters: + - name: educationSchool-id + in: path + description: The unique identifier of educationSchool + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSchool + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationClassCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + '/education/schools/{educationSchool-id}/classes/{educationClass-id}/$ref': + delete: + tags: + - education.educationSchool + summary: Remove educationClass + description: Delete a class from a school. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationschool-delete-classes?view=graph-rest-1.0 + operationId: education.school.class_DeleteEducationClassGraphBPreRef + parameters: + - name: educationSchool-id + in: path + description: The unique identifier of educationSchool + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSchool + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/schools/{educationSchool-id}/classes/$count': + get: + tags: + - education.educationSchool + summary: Get the number of the resource + operationId: education.school.class_GetCount + parameters: + - name: educationSchool-id + in: path + description: The unique identifier of educationSchool + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSchool + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/schools/{educationSchool-id}/classes/$ref': + get: + tags: + - education.educationSchool + summary: List classes of an educationSchool + description: Get the educationClass resources owned by an educationSchool. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationschool-list-classes?view=graph-rest-1.0 + operationId: education.school_ListClassGraphBPreRef + parameters: + - name: educationSchool-id + in: path + description: The unique identifier of educationSchool + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSchool + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/StringCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationSchool + summary: Add educationClass to educationSchool + description: Add a class to a school. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationschool-post-classes?view=graph-rest-1.0 + operationId: education.school_CreateClassGraphBPreRef + parameters: + - name: educationSchool-id + in: path + description: The unique identifier of educationSchool + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSchool + requestBody: + $ref: '#/components/requestBodies/refPostBody' + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationSchool + summary: Remove educationClass + description: Delete a class from a school. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationschool-delete-classes?view=graph-rest-1.0 + operationId: education.school_DeleteClassGraphBPreRef + parameters: + - name: educationSchool-id + in: path + description: The unique identifier of educationSchool + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSchool + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + - name: '@id' + in: query + description: The delete Uri + required: true + style: form + explode: false + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/schools/{educationSchool-id}/users': + get: + tags: + - education.educationSchool + summary: List users of an educationSchool + description: Get the educationUser resources associated with an educationSchool. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationschool-list-users?view=graph-rest-1.0 + operationId: education.school_ListUser + parameters: + - name: educationSchool-id + in: path + description: The unique identifier of educationSchool + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSchool + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationUserCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + '/education/schools/{educationSchool-id}/users/{educationUser-id}/$ref': + delete: + tags: + - education.educationSchool + summary: Remove educationUser from an educationSchool + description: Delete a user from a school. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationschool-delete-users?view=graph-rest-1.0 + operationId: education.school.user_DeleteEducationUserGraphBPreRef + parameters: + - name: educationSchool-id + in: path + description: The unique identifier of educationSchool + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSchool + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/schools/{educationSchool-id}/users/$count': + get: + tags: + - education.educationSchool + summary: Get the number of the resource + operationId: education.school.user_GetCount + parameters: + - name: educationSchool-id + in: path + description: The unique identifier of educationSchool + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSchool + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/schools/{educationSchool-id}/users/$ref': + get: + tags: + - education.educationSchool + summary: List users of an educationSchool + description: Get the educationUser resources associated with an educationSchool. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationschool-list-users?view=graph-rest-1.0 + operationId: education.school_ListUserGraphBPreRef + parameters: + - name: educationSchool-id + in: path + description: The unique identifier of educationSchool + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSchool + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/StringCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationSchool + summary: Add educationUser to an educationSchool + description: Add a user to a school. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationschool-post-users?view=graph-rest-1.0 + operationId: education.school_CreateUserGraphBPreRef + parameters: + - name: educationSchool-id + in: path + description: The unique identifier of educationSchool + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSchool + requestBody: + $ref: '#/components/requestBodies/refPostBody' + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationSchool + summary: Remove educationUser from an educationSchool + description: Delete a user from a school. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationschool-delete-users?view=graph-rest-1.0 + operationId: education.school_DeleteUserGraphBPreRef + parameters: + - name: educationSchool-id + in: path + description: The unique identifier of educationSchool + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSchool + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + - name: '@id' + in: query + description: The delete Uri + required: true + style: form + explode: false + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + /education/schools/$count: + get: + tags: + - education.educationSchool + summary: Get the number of the resource + operationId: education.school_GetCount + parameters: + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + /education/schools/microsoft.graph.delta(): + get: + tags: + - education.educationSchool + summary: Invoke function delta + description: Get newly created or updated schools without having to perform a full read of the entire school collection. See Use delta query for details. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationschool-delta?view=graph-rest-1.0 + operationId: education.school_delta + parameters: + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Success + content: + application/json: + schema: + title: Collection of educationSchool + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.educationSchool' + '@odata.nextLink': + type: string + nullable: true + '@odata.deltaLink': + type: string + nullable: true + additionalProperties: + type: object + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: function + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + /education/users: + get: + tags: + - education.educationUser + summary: List educationUsers + description: Get a list of the educationUser objects and their properties. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationuser-list?view=graph-rest-1.0 + operationId: education_ListUser + parameters: + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationUserCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationUser + summary: Create educationUser + description: Create a new educationUser object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationuser-post?view=graph-rest-1.0 + operationId: education_CreateUser + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationUser' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationUser' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}': + get: + tags: + - education.educationUser + summary: Get educationUser + description: Read the properties and relationships of an educationUser object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationuser-get?view=graph-rest-1.0 + operationId: education_GetUser + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationUser' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationUser + summary: Update educationUser + description: Update the properties of an educationUser object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationuser-update?view=graph-rest-1.0 + operationId: education_UpdateUser + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationUser' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationUser' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete educationUser + description: Delete a user. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationuser-delete?view=graph-rest-1.0 + operationId: education_DeleteUser + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/assignments': + get: + tags: + - education.educationUser + summary: List assignments of a user + description: 'Returns a list of educationAssignment assigned to a educationUser for all classes. Only teachers, students, and applications with application permissions can perform this operation. This method allows a caller to find all the assignments belonging to a student or a teacher in a single call rather than having to request assignments from each class. The assignment list contains what is needed to get the detailed information for the assignment from within the class namespace. Use the methods defined for the assignment for all other operations.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationuser-list-assignments?view=graph-rest-1.0 + operationId: education.user_ListAssignment + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationAssignmentCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationUser + summary: Create new navigation property to assignments for education + operationId: education.user_CreateAssignment + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}': + get: + tags: + - education.educationUser + summary: Get assignments from education + description: Assignments belonging to the user. + operationId: education.user_GetAssignment + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationUser + summary: Update the navigation property assignments in education + operationId: education.user_UpdateAssignment + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete navigation property assignments for education + operationId: education.user_DeleteAssignment + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/categories': + get: + tags: + - education.educationUser + summary: Get categories from education + description: 'When set, enables users to easily find assignments of a given type. Read-only. Nullable.' + operationId: education.user.assignment_ListCategory + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationCategoryCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationUser + summary: Create new navigation property to categories for education + operationId: education.user.assignment_CreateCategory + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationCategory' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationCategory' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/categories/{educationCategory-id}/$ref': + delete: + tags: + - education.educationUser + summary: Delete ref of navigation property categories for education + operationId: education.user.assignment.category_DeleteEducationCategoryGraphBPreRef + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationCategory-id + in: path + description: The unique identifier of educationCategory + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationCategory + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/categories/$count': + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.user.assignment.category_GetCount + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/categories/$ref': + get: + tags: + - education.educationUser + summary: Get ref of categories from education + description: 'When set, enables users to easily find assignments of a given type. Read-only. Nullable.' + operationId: education.user.assignment_ListCategoryGraphBPreRef + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/StringCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationUser + summary: Create new navigation property ref to categories for education + operationId: education.user.assignment_CreateCategoryGraphBPreRef + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + requestBody: + $ref: '#/components/requestBodies/refPostBody' + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete ref of navigation property categories for education + operationId: education.user.assignment_DeleteCategoryGraphBPreRef + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + - name: '@id' + in: query + description: The delete Uri + required: true + style: form + explode: false + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/categories/microsoft.graph.delta()': + get: + tags: + - education.educationUser + summary: Invoke function delta + description: Get a list of newly created or updated educationCategory objects without having to perform a full read of the collection. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationcategory-delta?view=graph-rest-1.0 + operationId: education.user.assignment.category_delta + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Success + content: + application/json: + schema: + title: Collection of educationCategory + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.educationCategory' + '@odata.nextLink': + type: string + nullable: true + '@odata.deltaLink': + type: string + nullable: true + additionalProperties: + type: object + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: function + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/gradingCategory': + get: + tags: + - education.educationUser + summary: Get gradingCategory from education + description: 'When set, enables users to weight assignments differently when computing a class average grade.' + operationId: education.user.assignment_GetGradingCategory + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationGradingCategory' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/microsoft.graph.activate': + post: + tags: + - education.educationUser + summary: Invoke action activate + description: Activate an inactive educationAssignment to signal that the assignment has further action items for teachers or students. This action can only be performed by a teacher on currently inactive assignments. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-activate?view=graph-rest-1.0 + operationId: education.user.assignment_activate + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/microsoft.graph.deactivate': + post: + tags: + - education.educationUser + summary: Invoke action deactivate + description: Mark an assigned educationAssignment as inactive to signal that the assignment has no further action items for teachers and students. This action can only be performed by a teacher on assigned assignments. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-deactivate?view=graph-rest-1.0 + operationId: education.user.assignment_deactivate + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/microsoft.graph.publish': + post: + tags: + - education.educationUser + summary: Invoke action publish + description: 'Publish an education assignment. Change the status of an educationAssignment from its original draft status to the published status. You can change the status from draft to scheduled if the assignment is scheduled for a future date. Only a teacher in the class can make this call. When an assignment is in draft status, students will not see the assignment, nor will there be any submission objects. Calling this API creates educationSubmission objects and displays the assignment in each student''s list. The status of the assignment goes back to draft if there is any backend failure during publish process. To update the properties of a published assignment, see update an assignment.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-publish?view=graph-rest-1.0 + operationId: education.user.assignment_publish + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/microsoft.graph.setUpFeedbackResourcesFolder': + post: + tags: + - education.educationUser + summary: Invoke action setUpFeedbackResourcesFolder + description: Create a SharePoint folder to upload feedback files for a given educationSubmission. Only teachers can perform this operation. The teacher determines the resources to upload in the feedback resources folder of a submission. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-setupfeedbackresourcesfolder?view=graph-rest-1.0 + operationId: education.user.assignment_setUpFeedbackResourcesFolder + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/microsoft.graph.setUpResourcesFolder': + post: + tags: + - education.educationUser + summary: Invoke action setUpResourcesFolder + description: 'Create a SharePoint folder to upload files for a given educationAssignment. Only teachers can perform this operation. The teacher determines the resources to upload in the assignment''s folder. ' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-setupresourcesfolder?view=graph-rest-1.0 + operationId: education.user.assignment_setUpResourcesFolder + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/resources': + get: + tags: + - education.educationUser + summary: Get resources from education + description: Learning objects that are associated with this assignment. Only teachers can modify this list. Nullable. + operationId: education.user.assignment_ListResource + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationAssignmentResourceCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationUser + summary: Create new navigation property to resources for education + operationId: education.user.assignment_CreateResource + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/resources/{educationAssignmentResource-id}': + get: + tags: + - education.educationUser + summary: Get resources from education + description: Learning objects that are associated with this assignment. Only teachers can modify this list. Nullable. + operationId: education.user.assignment_GetResource + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationAssignmentResource-id + in: path + description: The unique identifier of educationAssignmentResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignmentResource + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationUser + summary: Update the navigation property resources in education + operationId: education.user.assignment_UpdateResource + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationAssignmentResource-id + in: path + description: The unique identifier of educationAssignmentResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignmentResource + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationAssignmentResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete navigation property resources for education + operationId: education.user.assignment_DeleteResource + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationAssignmentResource-id + in: path + description: The unique identifier of educationAssignmentResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignmentResource + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/resources/$count': + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.user.assignment.resource_GetCount + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/rubric': + get: + tags: + - education.educationUser + summary: Get rubric from education + description: 'When set, the grading rubric attached to this assignment.' + operationId: education.user.assignment_GetRubric + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRubric' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationUser + summary: Update the navigation property rubric in education + operationId: education.user.assignment_UpdateRubric + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRubric' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRubric' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete navigation property rubric for education + operationId: education.user.assignment_DeleteRubric + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/rubric/$ref': + get: + tags: + - education.educationUser + summary: Get ref of rubric from education + description: 'When set, the grading rubric attached to this assignment.' + operationId: education.user.assignment_GetRubricGraphBPreRef + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + responses: + 2XX: + description: Retrieved navigation property link + content: + application/json: + schema: + type: string + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + put: + tags: + - education.educationUser + summary: Update the ref of navigation property rubric in education + operationId: education.user.assignment_SetRubricGraphBPreRef + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + requestBody: + $ref: '#/components/requestBodies/refPutBody' + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete ref of navigation property rubric for education + operationId: education.user.assignment_DeleteRubricGraphBPreRef + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions': + get: + tags: + - education.educationUser + summary: Get submissions from education + description: 'Once published, there''s a submission object for each student representing their work and grade. Read-only. Nullable.' + operationId: education.user.assignment_ListSubmission + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationSubmissionCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationUser + summary: Create new navigation property to submissions for education + operationId: education.user.assignment_CreateSubmission + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}': + get: + tags: + - education.educationUser + summary: Get submissions from education + description: 'Once published, there''s a submission object for each student representing their work and grade. Read-only. Nullable.' + operationId: education.user.assignment_GetSubmission + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationUser + summary: Update the navigation property submissions in education + operationId: education.user.assignment_UpdateSubmission + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete navigation property submissions for education + operationId: education.user.assignment_DeleteSubmission + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.excuse': + post: + tags: + - education.educationUser + summary: Invoke action excuse + description: 'Excuse a submission. Excused submissions aren''t included in average grade calculations. Grading rubrics and feedback are deleted. Only teachers can perform this action. If the Prefer: include-unknown-enum-members request header is provided, the excused submission shows the excused status. Otherwise, the submission status retains the returned status. For more information about how to use this header, see the Examples section.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-excuse?view=graph-rest-1.0 + operationId: education.user.assignment.submission_excuse + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.reassign': + post: + tags: + - education.educationUser + summary: Invoke action reassign + description: 'Reassign the submission to the student with feedback for review. Only teachers can perform this action. Include the Prefer: include-unknown-enum-members header when you call this method; otherwise, a reassigned submission is treated as a returned submission. This means that the reassigned status is mapped to the returned status, and reassignedDateTime and reassignedBy properties are mapped to returnedDateTime and returnedBy respectively. If the header Prefer: include-unknown-enum-members is provided, a reassigned submission retains the reassigned status. For details, see the examples section.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-reassign?view=graph-rest-1.0 + operationId: education.user.assignment.submission_reassign + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.return': + post: + tags: + - education.educationUser + summary: Invoke action return + description: Make the grade and feedback associated with this submission available to the student. This action changes the status of the submission from 'submitted' to 'returned' and indicates that feedback is provided or grading is done. This action can only be done by the teacher. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-return?view=graph-rest-1.0 + operationId: education.user.assignment.submission_return + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.setUpResourcesFolder': + post: + tags: + - education.educationUser + summary: Invoke action setUpResourcesFolder + description: 'Trigger the creation of the SharePoint resource folder where all file-based resources (Word, Excel, and so on) should be uploaded for a given submission. Only teachers and students can perform this operation. Note that files must be located in this folder in order to be added as resources. Only a student in the class can determine what files to upload in a given submission-level resource folder. ' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-setupresourcesfolder?view=graph-rest-1.0 + operationId: education.user.assignment.submission_setUpResourcesFolder + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.submit': + post: + tags: + - education.educationUser + summary: Invoke action submit + description: 'Indicate that a student is done with the work and is ready to hand in the assignment. Only teachers, students, and applications with application permissions can perform this operation. This method changes the status of the submission from working to submitted. During the submit process, all the resources are copied to the submittedResources bucket. The teacher will be looking at the submitted resources list for grading. A teacher can also submit a student''s assignment on their behalf.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-submit?view=graph-rest-1.0 + operationId: education.user.assignment.submission_submit + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/microsoft.graph.unsubmit': + post: + tags: + - education.educationUser + summary: Invoke action unsubmit + description: 'Indicate that a student wants to work on the submission of the assignment after it was turned in. Only teachers, students, and applications with application permissions can perform this operation. This method changes the status of the submission from submitted to working. During the submit process, all the resources are copied from submittedResources to workingResources. The teacher will be looking at the working resources list for grading. A teacher can also unsubmit a student''s assignment on their behalf.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationsubmission-unsubmit?view=graph-rest-1.0 + operationId: education.user.assignment.submission_unsubmit + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmission' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/outcomes': + get: + tags: + - education.educationUser + summary: Get outcomes from education + operationId: education.user.assignment.submission_ListOutcome + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationOutcomeCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationUser + summary: Create new navigation property to outcomes for education + operationId: education.user.assignment.submission_CreateOutcome + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationOutcome' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationOutcome' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/outcomes/{educationOutcome-id}': + get: + tags: + - education.educationUser + summary: Get outcomes from education + operationId: education.user.assignment.submission_GetOutcome + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationOutcome-id + in: path + description: The unique identifier of educationOutcome + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationOutcome + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationOutcome' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationUser + summary: Update the navigation property outcomes in education + operationId: education.user.assignment.submission_UpdateOutcome + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationOutcome-id + in: path + description: The unique identifier of educationOutcome + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationOutcome + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationOutcome' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationOutcome' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete navigation property outcomes for education + operationId: education.user.assignment.submission_DeleteOutcome + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationOutcome-id + in: path + description: The unique identifier of educationOutcome + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationOutcome + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/outcomes/$count': + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.user.assignment.submission.outcome_GetCount + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/resources': + get: + tags: + - education.educationUser + summary: Get resources from education + operationId: education.user.assignment.submission_ListResource + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationSubmissionResourceCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationUser + summary: Create new navigation property to resources for education + operationId: education.user.assignment.submission_CreateResource + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/resources/{educationSubmissionResource-id}': + get: + tags: + - education.educationUser + summary: Get resources from education + operationId: education.user.assignment.submission_GetResource + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationSubmissionResource-id + in: path + description: The unique identifier of educationSubmissionResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmissionResource + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationUser + summary: Update the navigation property resources in education + operationId: education.user.assignment.submission_UpdateResource + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationSubmissionResource-id + in: path + description: The unique identifier of educationSubmissionResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmissionResource + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete navigation property resources for education + operationId: education.user.assignment.submission_DeleteResource + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationSubmissionResource-id + in: path + description: The unique identifier of educationSubmissionResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmissionResource + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/resources/$count': + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.user.assignment.submission.resource_GetCount + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/submittedResources': + get: + tags: + - education.educationUser + summary: Get submittedResources from education + operationId: education.user.assignment.submission_ListSubmittedResource + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationSubmissionResourceCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationUser + summary: Create new navigation property to submittedResources for education + operationId: education.user.assignment.submission_CreateSubmittedResource + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/submittedResources/{educationSubmissionResource-id}': + get: + tags: + - education.educationUser + summary: Get submittedResources from education + operationId: education.user.assignment.submission_GetSubmittedResource + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationSubmissionResource-id + in: path + description: The unique identifier of educationSubmissionResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmissionResource + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationUser + summary: Update the navigation property submittedResources in education + operationId: education.user.assignment.submission_UpdateSubmittedResource + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationSubmissionResource-id + in: path + description: The unique identifier of educationSubmissionResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmissionResource + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSubmissionResource' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete navigation property submittedResources for education + operationId: education.user.assignment.submission_DeleteSubmittedResource + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - name: educationSubmissionResource-id + in: path + description: The unique identifier of educationSubmissionResource + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmissionResource + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/{educationSubmission-id}/submittedResources/$count': + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.user.assignment.submission.submittedResource_GetCount + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - name: educationSubmission-id + in: path + description: The unique identifier of educationSubmission + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSubmission + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/users/{educationUser-id}/assignments/{educationAssignment-id}/submissions/$count': + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.user.assignment.submission_GetCount + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationAssignment-id + in: path + description: The unique identifier of educationAssignment + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationAssignment + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/users/{educationUser-id}/assignments/$count': + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.user.assignment_GetCount + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/users/{educationUser-id}/assignments/microsoft.graph.delta()': + get: + tags: + - education.educationUser + summary: Invoke function delta + description: Get a list of newly-created or updated assignments without reading the whole collection. A teacher or an application running with application permissions can see all assignment objects for the class. Students can only see assignments that are assigned to them. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationassignment-delta?view=graph-rest-1.0 + operationId: education.user.assignment_delta + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Success + content: + application/json: + schema: + title: Collection of educationAssignment + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.educationAssignment' + '@odata.nextLink': + type: string + nullable: true + '@odata.deltaLink': + type: string + nullable: true + additionalProperties: + type: object + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: function + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + '/education/users/{educationUser-id}/classes': + get: + tags: + - education.educationUser + summary: Get classes from education + description: Classes to which the user belongs. Nullable. + operationId: education.user_ListClass + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationClassCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/classes/{educationClass-id}': + get: + tags: + - education.educationUser + summary: Get classes from education + description: Classes to which the user belongs. Nullable. + operationId: education.user_GetClass + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationClass' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/classes/$count': + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.user.class_GetCount + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/users/{educationUser-id}/rubrics': + get: + tags: + - education.educationUser + summary: Get rubrics from education + description: 'When set, the grading rubric attached to the assignment.' + operationId: education.user_ListRubric + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationRubricCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - education.educationUser + summary: Create new navigation property to rubrics for education + operationId: education.user_CreateRubric + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRubric' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRubric' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/rubrics/{educationRubric-id}': + get: + tags: + - education.educationUser + summary: Get rubrics from education + description: 'When set, the grading rubric attached to the assignment.' + operationId: education.user_GetRubric + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationRubric-id + in: path + description: The unique identifier of educationRubric + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationRubric + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRubric' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - education.educationUser + summary: Update the navigation property rubrics in education + operationId: education.user_UpdateRubric + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationRubric-id + in: path + description: The unique identifier of educationRubric + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationRubric + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRubric' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationRubric' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - education.educationUser + summary: Delete navigation property rubrics for education + operationId: education.user_DeleteRubric + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationRubric-id + in: path + description: The unique identifier of educationRubric + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationRubric + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/rubrics/$count': + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.user.rubric_GetCount + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/users/{educationUser-id}/schools': + get: + tags: + - education.educationUser + summary: Get schools from education + description: Schools to which the user belongs. Nullable. + operationId: education.user_ListSchool + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationSchoolCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/schools/{educationSchool-id}': + get: + tags: + - education.educationUser + summary: Get schools from education + description: Schools to which the user belongs. Nullable. + operationId: education.user_GetSchool + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationSchool-id + in: path + description: The unique identifier of educationSchool + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationSchool + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationSchool' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/schools/$count': + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.user.school_GetCount + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/users/{educationUser-id}/taughtClasses': + get: + tags: + - education.educationUser + summary: List taughtClasses + description: Get the educationClass resources owned by an educationUser. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationuser-list-taughtclasses?view=graph-rest-1.0 + operationId: education.user_ListTaughtClass + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.educationClassCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/taughtClasses/{educationClass-id}': + get: + tags: + - education.educationUser + summary: Get taughtClasses from education + description: Classes for which the user is a teacher. + operationId: education.user_GetTaughtClass + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: educationClass-id + in: path + description: The unique identifier of educationClass + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationClass + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.educationClass' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/taughtClasses/$count': + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.user.taughtClass_GetCount + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/education/users/{educationUser-id}/user': + get: + tags: + - education.educationUser + summary: Get user from education + description: The directory user that corresponds to this user. + operationId: education.user_GetUser + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.user' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/education/users/{educationUser-id}/user/mailboxSettings': + get: + tags: + - education.educationUser + summary: Get mailboxSettings property value + description: 'Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time zone. Returned only on $select.' + operationId: education.user_GetMailboxSetting + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Entity result. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.mailboxSettings' + default: + $ref: '#/components/responses/error' + patch: + tags: + - education.educationUser + summary: Update property mailboxSettings value. + operationId: education.user_UpdateMailboxSetting + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + requestBody: + description: New property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.mailboxSettings' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.mailboxSettings' + default: + $ref: '#/components/responses/error' + '/education/users/{educationUser-id}/user/serviceProvisioningErrors': + get: + tags: + - education.educationUser + summary: Get serviceProvisioningErrors property value + description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).' + operationId: education.user_ListServiceProvisioningError + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + '/education/users/{educationUser-id}/user/serviceProvisioningErrors/$count': + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.user.ServiceProvisioningError_GetCount + parameters: + - name: educationUser-id + in: path + description: The unique identifier of educationUser + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: educationUser + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + /education/users/$count: + get: + tags: + - education.educationUser + summary: Get the number of the resource + operationId: education.user_GetCount + parameters: + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + /education/users/microsoft.graph.delta(): + get: + tags: + - education.educationUser + summary: Invoke function delta + description: Get newly created or updated educationUser without having to perform a full read of the entire collection. See Use delta query for details. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/educationuser-delta?view=graph-rest-1.0 + operationId: education.user_delta + parameters: + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $expand + in: query + description: Expand related entities + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + description: Success + content: + application/json: + schema: + title: Collection of educationUser + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.educationUser' + '@odata.nextLink': + type: string + nullable: true + '@odata.deltaLink': + type: string + nullable: true + additionalProperties: + type: object + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: function + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore components: schemas: microsoft.graph.educationRoot: @@ -17521,4 +31508,4 @@ components: tokenUrl: https://login.microsoftonline.com/common/oauth2/v2.0/token scopes: { } security: - - azureaadv2: [ ] + - azureaadv2: [ ] \ No newline at end of file From e7e4e5f02011d6eb61f89035845da8031c1e4fcd Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Thu, 8 May 2025 10:39:41 +0300 Subject: [PATCH 23/24] Removed faulty property tracking related files --- tools/Custom/IPropertyTracker.cs | 9 ---- tools/Custom/PropertyTracker.cs | 76 -------------------------------- 2 files changed, 85 deletions(-) delete mode 100644 tools/Custom/IPropertyTracker.cs delete mode 100644 tools/Custom/PropertyTracker.cs diff --git a/tools/Custom/IPropertyTracker.cs b/tools/Custom/IPropertyTracker.cs deleted file mode 100644 index 1eb7db34169..00000000000 --- a/tools/Custom/IPropertyTracker.cs +++ /dev/null @@ -1,9 +0,0 @@ -namespace NamespacePrefixPlaceholder.PowerShell.Models -{ - public interface IPropertyTracker - { - void TrackProperty(string propertyName); - bool IsPropertySet(string propertyName); - T SanitizeValue(object value); - } -} \ No newline at end of file diff --git a/tools/Custom/PropertyTracker.cs b/tools/Custom/PropertyTracker.cs deleted file mode 100644 index 0bc1312dd6c..00000000000 --- a/tools/Custom/PropertyTracker.cs +++ /dev/null @@ -1,76 +0,0 @@ -using System; -using System.Collections.Generic; - - -namespace NamespacePrefixPlaceholder.PowerShell.Models -{ - public class PropertyTracker - { - private readonly HashSet _trackedProperties = new HashSet(); - - public void TrackProperty(string propertyName) - { - if (!string.IsNullOrWhiteSpace(propertyName)) - { - propertyName = char.ToLower(propertyName[0]) + propertyName.Substring(1); // ✅ force camelCase - _trackedProperties.Add(propertyName); // ✅ Track properties that are set - } - } - - public bool IsPropertySet(string propertyName) - { - // Ensure that the first character of the property name is UpperCase - if (propertyName.Length > 0) - { - propertyName = char.ToLower(propertyName[0]) + propertyName.Substring(1); // ✅ match camelCase - } - return _trackedProperties.Contains(propertyName); - } - public static T SanitizeValue(object value) - { - if (typeof(T) == typeof(string)) - { - return (T)(object)(string.IsNullOrEmpty(value as string) ? null : value); - } - return (T)value; - } - public static NamespacePrefixPlaceholder.PowerShell.Runtime.Json.JsonNode ConvertToJsonNode(Type propertyType, object value) - { - if (value == null) - { - return new NamespacePrefixPlaceholder.PowerShell.Runtime.Json.JsonString("null"); // Explicitly return null if the property is set to null - } - - // Get the declared property type using reflection - - - // Handle different types based on the declared type - if (propertyType == typeof(string)) - { - return new NamespacePrefixPlaceholder.PowerShell.Runtime.Json.JsonString(value.ToString()); - } - else if (propertyType == typeof(int) || propertyType == typeof(int?) || - propertyType == typeof(long) || propertyType == typeof(long?) || - propertyType == typeof(short) || propertyType == typeof(short?)) - { - return new NamespacePrefixPlaceholder.PowerShell.Runtime.Json.JsonNumber(Convert.ToDouble(value)); - } - else if (propertyType == typeof(bool) || propertyType == typeof(bool?)) - { - return new NamespacePrefixPlaceholder.PowerShell.Runtime.Json.JsonBoolean((bool)value); - } - else if (propertyType.IsEnum) - { - return new NamespacePrefixPlaceholder.PowerShell.Runtime.Json.JsonString(value.ToString()); - } - else if (propertyType == typeof(DateTime) || propertyType == typeof(DateTime?)) - { - return new NamespacePrefixPlaceholder.PowerShell.Runtime.Json.JsonString(((DateTime)value).ToString("o")); // ISO 8601 format - } - - // Fallback to JSON object if the type is complex - return NamespacePrefixPlaceholder.PowerShell.Runtime.Json.JsonObject.FromObject(value); - } - } -} - From e0b11c2481f30b1f551b58431026a18df662bd55 Mon Sep 17 00:00:00 2001 From: Timothy Wamalwa Date: Thu, 8 May 2025 16:42:54 +0300 Subject: [PATCH 24/24] Removed property tracker implementation from custom modules --- src/Teams/beta/custom/MicrosoftGraphRscConfiguration.cs | 4 ---- src/Teams/beta/custom/MicrosoftGraphTeamsAppPreApproval.cs | 4 ---- 2 files changed, 8 deletions(-) diff --git a/src/Teams/beta/custom/MicrosoftGraphRscConfiguration.cs b/src/Teams/beta/custom/MicrosoftGraphRscConfiguration.cs index 59c19bc9ed7..260f2b36987 100644 --- a/src/Teams/beta/custom/MicrosoftGraphRscConfiguration.cs +++ b/src/Teams/beta/custom/MicrosoftGraphRscConfiguration.cs @@ -15,10 +15,6 @@ public partial class MicrosoftGraphRscConfiguration : IMicrosoftGraphRscConfigurationInternal, Runtime.IValidates { - private readonly PropertyTracker _propertyTracker = new PropertyTracker(); - public void TrackProperty(string propertyName) => _propertyTracker.TrackProperty(propertyName); - public bool IsPropertySet(string propertyName) =>_propertyTracker.IsPropertySet(propertyName); - public T SanitizeValue(object value) => PropertyTracker.SanitizeValue(value); /// /// Backing field for Inherited model /// diff --git a/src/Teams/beta/custom/MicrosoftGraphTeamsAppPreApproval.cs b/src/Teams/beta/custom/MicrosoftGraphTeamsAppPreApproval.cs index af7f1c44b91..5e1fb804a41 100644 --- a/src/Teams/beta/custom/MicrosoftGraphTeamsAppPreApproval.cs +++ b/src/Teams/beta/custom/MicrosoftGraphTeamsAppPreApproval.cs @@ -15,10 +15,6 @@ public partial class MicrosoftGraphTeamsAppPreApproval : IMicrosoftGraphTeamsAppPreApprovalInternal, Runtime.IValidates { - private readonly PropertyTracker _propertyTracker = new PropertyTracker(); - public void TrackProperty(string propertyName) => _propertyTracker.TrackProperty(propertyName); - public bool IsPropertySet(string propertyName) =>_propertyTracker.IsPropertySet(propertyName); - public T SanitizeValue(object value) => PropertyTracker.SanitizeValue(value); /// /// Backing field for Inherited model