v1

latestOpenAPI 3.1.02026-08-04164270844.7 KB
Paths

Edit a child path session

🔑

Required OAuth scope: paths:write.

Edits a child path session given its unique ID and path.

patch/api/v2/paths/{pathId}/child-sessions/{childSessionId}

Path parameters

pathIdstring ObjectId required
Example:507f1f77bcf86cd799439011

The unique ID of the path.

childSessionIdstring 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.

mainInstructorIdstring ObjectId

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

instructorIdsstring[]

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

Example request

{
  "additionalInformation": "A0015221",
  "mainInstructorId": "507f1f77bcf86cd799439011",
  "instructorIds": [
    "507f1f77bcf86cd799439011"
  ]
}

Response

Returns the updated child 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"
      }
    }
  ]
}