Sign in

v1

latestOpenAPI 3.1.02026-08-04164270844.7 KB
Paths

Edit a path session

🔑

Required OAuth scope: paths:write.

Edits specific fields of an existing path session. Fields not included in the request payload remain unchanged.

patch/api/v2/paths/{pathId}/sessions/{sessionId}

Path parameters

pathIdstring ObjectId required
Example:507f1f77bcf86cd799439011

The unique ID of the path.

sessionIdstring ObjectId required
Example:507f1f77bcf86cd799439011

The unique ID of the path session.

Headers

360-api-version'v2.0' required

The version of the API.

Request body

additionalInformationstring nullable

The additional information of the path session.

instructorIdsstring[]

The list of unique IDs of the co-instructors of the path session. The update of instructorIds modifies instructorIds in child path sessions.

mainInstructorIdstring ObjectId

The unique ID of the main instructor of the path session. The update of mainInstructorId modifies mainInstructorId in child path sessions.

namestring

The title of the path session.

groupIdstring ObjectId

The unique ID of the path session owner group.

registrationRequestValidation'disabled' | 'instructors' | 'managers' | 'adminsAndManagers' | 'adminsCoachesInstructorsManagers'

The registration request validation options for open access registrations. Options are:

  • disabled: There is no validation for registration.
  • instructors: The instructors validate the registration request.
  • managers: The managers validate the registration request.
  • adminsAndManagers: The managers and group admin validate the registration request.
  • adminsCoachesInstructorsManagers:Managers, instructors, group admins and coaches validate the registration request.
startDatestring date-time

The date and time when the path session starts, in the YYYY-MM-DDThh:mm:ss.sssZ format (ISO 8601 in Coordinated Universal Time (UTC)).

endDatestring date-time nullable

The date and time when the path session ends, in the YYYY-MM-DDThh:mm:ss.sssZ format (ISO 8601 in Coordinated Universal Time (UTC)).

userLimitinteger nullable

The maximum number of learners that can self enroll in the path session.

Example request

{
  "additionalInformation": "A0015221",
  "instructorIds": [
    "507f1f77bcf86cd799439011"
  ],
  "mainInstructorId": "507f1f77bcf86cd799439011",
  "name": "Employee Onboarding October Session.",
  "groupId": "507f1f77bcf86cd799439011",
  "automaticReenrollment": {
    "delayDays": 90
  }
}

Response

Returns the updated session.

mainInstructorIdstring ObjectId required

The unique ID of the main instructor of the path session.

registrationRequestValidation'disabled' | 'instructors' | 'managers' | 'adminsAndManagers' | 'adminsCoachesInstructorsManagers' required

The registration request validation options for open access registrations. Options are:

  • disabled: There is no validation for registration.
  • instructors: The instructors validate the registration request.
  • managers: The managers validate the registration request.
  • adminsAndManagers: The managers and group admin validate the registration request.
  • adminsCoachesInstructorsManagers:Managers, instructors, group admins and coaches validate the registration request.
startDatestring date-time required

The date and time when the path session starts, in the YYYY-MM-DDThh:mm:ss.sssZ format (ISO 8601 in Coordinated Universal Time (UTC)).

endDatestring date-time

The date and time when the path session ends, in the YYYY-MM-DDThh:mm:ss.sssZ format (ISO 8601 in Coordinated Universal Time (UTC)).

userLimitinteger

The maximum number of learners that can self enroll in the path session.

_idstring ObjectId required

The unique ID of the path session.

createdAtstring date-time required

The date and time when the path session was created, in the YYYY-MM-DDThh:mm:ss.sssZ format (ISO 8601 in Coordinated Universal Time (UTC)).

groupIdstring ObjectId required

The unique ID of the path session owner group.

instructorIdsstring[] required

The list of unique IDs of the co-instructors of the path session.

isAudienceBuilderboolean required

True if the path session is an audience builder session; false otherwise.

modifiedAtstring date-time required

The date and time when the path session was last updated, in the YYYY-MM-DDThh:mm:ss.sssZ format (ISO 8601 in Coordinated Universal Time (UTC)).

namestring required

The title of the path session.

pathIdstring ObjectId required

The unique ID of the path the session belongs to.

additionalInformationstring

The additional information of the path session.

rootSessionIdstring ObjectId

The unique ID of the root session.

Example response

{
  "mainInstructorId": "507f1f77bcf86cd799439011",
  "automaticReenrollment": {
    "delayDays": 90
  },
  "_id": "507f1f77bcf86cd799439011",
  "groupId": "507f1f77bcf86cd799439011",
  "instructorIds": [
    "507f1f77bcf86cd799439011"
  ],
  "name": "Employee Onboarding October Session.",
  "pathId": "507f1f77bcf86cd799439011",
  "additionalInformation": "A0015221",
  "rootSessionId": "507f1f77bcf86cd799439011",
  "translations": [
    {
      "lang": "fr",
      "translatorIds": [
        "507f1f77bcf86cd799439011"
      ],
      "translatedFields": {
        "name": "Accueil des employés Session d'Octobre"
      }
    }
  ]
}