ESC
Type to search...
↑↓ Navigate ↵ Open ESC Close

LearningSelfInitiatedCourse.ReadWrite.All

Export JSON
Export CSV
Copy URL
Print
Application Read/Write All Resources

Allows the app to create, update, read and delete all self-initiated courses in the organization's directory, without a signed-in user.

Permission data: April 6, 2026 at 4:06 AM UTC
Delegated Access App-Only Access

Permission Details

Application Permission

Read and write all self-initiated courses

Allows the app to create, update, read and delete all self-initiated courses in the organization's directory, without a signed-in user.

Permission ID: 7654ed61-8965-4025-846a-0856ec02b5b0

Properties

Microsoft Graph v1.0 exact-category-docs

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property Type Description
@odata.type String Indicates if it is a learningAssignment or learningSelfInitiated course activity. Required.
completedDateTime DateTimeOffsetNullable Date and time when the assignment was completed. Optional. Inherited from learningCourseActivity.
completionPercentage Int32Nullable The percentage of the course completed by the user. If the value is provided, the value needs to be between 0 and 100 (inclusive). Optional. Inherited from learningCourseActivity.
externalCourseActivityId String A course activity ID generated by the provider. Optional. Inherited from learningCourseActivity.
id String A generated ID that can be used with other course activity APIs. Inherited from learningCourseActivity.
learningContentId String The ID of the learning content created in Viva Learning. Required. Inherited from learningCourseActivity.
learnerUserId String The user ID of the learner who initiated the course. Required. Inherited from learningCourseActivity.
learningProviderId StringNullable The registration ID of the provider. Required. Inherited from learningCourseActivity.
startedDateTime DateTimeOffsetNullable The date and time on which the learner started the self-initiated course. Optional.
status courseStatus The status of the course activity. Possible values are inProgress, completed. Optional. Inherited from learningCourseActivity.
externalcourseActivityId stringNullable

JSON Representation

Microsoft Graph v1.0 exact-category-docs

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation 
{
  "@odata.type": "#microsoft.graph.learningSelfInitiatedCourse",
  "completedDateTime": "String (timestamp)",
  "completionPercentage": "Int32",
  "externalCourseActivityId": "String",
  "id": "String (identifier)",
  "learningContentId": "String",
  "learningProviderId": "String",
  "learnerUserId": "String",
  "startedDateTime": "String (timestamp)",
  "status": {
    "@odata.type": "microsoft.graph.courseStatus"
  }
}

Relationships

Relationships metadata is not available for this permission mapping.

View resource documentation

Graph Methods

Delegated access App-only access
Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /employeeExperience/learningCourseActivities/{Id}
GET /employeeExperience/learningProviders/{registrationId}/learningCourseActivities(externalCourseActivityId='{externalCourseActivityId}')
GET /me/employeeExperience/learningCourseActivities/{id}
GET /users/{user-id}/employeeExperience/learningCourseActivities/{id}
POST /employeeExperience/learningProviders/{registrationId}/learningCourseActivities
PATCH /employeeExperience/learningProviders/{registrationId}/learningCourseActivities/{learningCourseActivityId}
DELETE /employeeExperience/learningProviders/{registrationId}/learningCourseActivities/{id}
Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /employeeExperience/learningCourseActivities/{Id}
GET /employeeExperience/learningProviders/{registrationId}/learningCourseActivities(externalCourseActivityId={externalCourseActivityId})
GET /me/employeeExperience/learningCourseActivities/{id}
GET /users/{user-id}/employeeExperience/learningCourseActivities/{id}
POST /employeeExperience/learningProviders/{registrationId}/learningCourseActivities
PATCH /employeeExperience/learningProviders/{registrationId}/learningCourseActivities/{learningCourseActivityId}
DELETE /employeeExperience/learningProviders/{registrationId}/learningCourseActivities/{id}
No Microsoft Learn PowerShell mapping available

Microsoft Graph PowerShell v1.0 commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.

No deterministic PowerShell command map is available for this permission.

Browse PowerShell docs
No Microsoft Learn PowerShell mapping available

Microsoft Graph PowerShell beta commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.

No deterministic PowerShell command map is available for this permission.

Browse PowerShell docs

Code Examples

C# / .NET SDK
Create learningCourseActivity
View official example on Microsoft Learn
// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new LearningAssignment
{
	OdataType = "#microsoft.graph.learningAssignment",
	AssignedDateTime = DateTimeOffset.Parse("2021-05-11T22:57:17+00:00"),
	AssignmentType = AssignmentType.Required,
	AssignerUserId = "cea1684d-57dc-438d-a9d1-e666ec1a7f3d",
	CompletedDateTime = null,
	CompletionPercentage = 20,
	DueDateTime = new DateTimeTimeZone
	{
		DateTime = "2022-09-22T16:05:00.0000000",
		TimeZone = "UTC",
	},
	ExternalCourseActivityId = "12a2228a-e020-11ec-9d64-0242ac120002",
	LearningContentId = "57baf9dc-e020-11ec-9d64-0242ac120002",
	LearningProviderId = "01e8f81b-3060-4dec-acf0-0389665a0a38",
	LearnerUserId = "7ba2228a-e020-11ec-9d64-0242ac120002",
	Notes = new ItemBody
	{
		ContentType = BodyType.Text,
		Content = "required assignment added for user",
	},
	Status = CourseStatus.NotStarted,
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.EmployeeExperience.LearningProviders["{learningProvider-id}"].LearningCourseActivities.PostAsync(requestBody);
JavaScript
Create learningCourseActivity
View official example on Microsoft Learn
const options = {
	authProvider,
};

const client = Client.init(options);

const learningCourseActivity = {
  '@odata.type': '#microsoft.graph.learningAssignment',
  assignedDateTime: '2021-05-11T22:57:17+00:00',
  assignmentType: 'required',
  assignerUserId: 'cea1684d-57dc-438d-a9d1-e666ec1a7f3d',
  completedDateTime: null,
  completionPercentage: 20,
  dueDateTime: {
    dateTime: '2022-09-22T16:05:00.0000000',
    timeZone: 'UTC'
  },
  externalCourseActivityId: '12a2228a-e020-11ec-9d64-0242ac120002',
  learningContentId: '57baf9dc-e020-11ec-9d64-0242ac120002',
  learningProviderId: '01e8f81b-3060-4dec-acf0-0389665a0a38',
  learnerUserId: '7ba2228a-e020-11ec-9d64-0242ac120002',
  notes: {
    contentType: 'text',
    content: 'required assignment added for user'
  },
  status: 'notStarted'
};

await client.api('/employeeExperience/learningProviders/01e8f81b-3060-4dec-acf0-0389665a0a38/learningCourseActivities')
	.post(learningCourseActivity);
PowerShell 
Connect-MgGraph -Scopes "LearningSelfInitiatedCourse.ReadWrite.All"
Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/v1.0/employeeExperience/learningCourseActivities/{id}"
Python
Create learningCourseActivity
View official example on Microsoft Learn
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.learning_assignment import LearningAssignment
from msgraph.generated.models.assignment_type import AssignmentType
from msgraph.generated.models.date_time_time_zone import DateTimeTimeZone
from msgraph.generated.models.item_body import ItemBody
from msgraph.generated.models.body_type import BodyType
from msgraph.generated.models.course_status import CourseStatus
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = LearningAssignment(
	odata_type = "#microsoft.graph.learningAssignment",
	assigned_date_time = "2021-05-11T22:57:17+00:00",
	assignment_type = AssignmentType.Required,
	assigner_user_id = "cea1684d-57dc-438d-a9d1-e666ec1a7f3d",
	completed_date_time = None,
	completion_percentage = 20,
	due_date_time = DateTimeTimeZone(
		date_time = "2022-09-22T16:05:00.0000000",
		time_zone = "UTC",
	),
	external_course_activity_id = "12a2228a-e020-11ec-9d64-0242ac120002",
	learning_content_id = "57baf9dc-e020-11ec-9d64-0242ac120002",
	learning_provider_id = "01e8f81b-3060-4dec-acf0-0389665a0a38",
	learner_user_id = "7ba2228a-e020-11ec-9d64-0242ac120002",
	notes = ItemBody(
		content_type = BodyType.Text,
		content = "required assignment added for user",
	),
	status = CourseStatus.NotStarted,
)

result = await graph_client.employee_experience.learning_providers.by_learning_provider_id('learningProvider-id').learning_course_activities.post(request_body)

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Application permissions and search for LearningSelfInitiatedCourse.ReadWrite.All

4

Grant Admin Consent

Application permissions always require admin consent.