36360learning
Classrooms

Add a slot to a classroom

Changed on

🔑

Required OAuth scope: classrooms:write.

Adds a slot to a given classroom.

post/api/v2/classrooms/{classroomId}/slots

Request

  • Base URL
    https://app.360learning.com
  • URL
    https://app.360learning.com/api/v2/classrooms/{classroomId}/slots
  • Auth
    OAuth 2
    Client credentials
    Token URL: /api/v2/oauth2/token

Path parameters

classroomIdstring ObjectId required
Example:507f1f77bcf86cd799439011

The unique ID of the classroom.

Headers

360-api-version'v2.0' required

The version of the API.

Request body

startDatestring date-time required

The date and time when the classroom slot starts (must be before endDate), in the YYYY-MM-DDThh:mm:ss.sssZ format (ISO 8601 in Coordinated Universal Time (UTC)).

endDatestring date-time required

The date and time when the classroom slot ends (must be after startDate), in the YYYY-MM-DDThh:mm:ss.sssZ format (ISO 8601 in Coordinated Universal Time (UTC)).

reportedDurationnumber required

The reported duration of the slot, in hours.

virtualboolean required

True when the slot is a virtual classroom, false otherwise.

maxCapacitynumber

The maximum number of registrations allowed in the slot. Learners won't be able to self-enroll on this slot if this number is reached.

namestring required

The title of the classroom slot.

locationstring required

The location of the classroom slot, being either a URL or a physical address.

trainerIdsstring[]

The list of unique user IDs of trainers in charge of the slot (users must exist in the company).

mediaIdsstring[]

The list of medias unique identifiers linked to the classroom slot.

timezonestring

The timezone of the slot in the format Continent[/Country]/City defined by TZ database.

authorIdstring ObjectId

The unique ID of the user who authored the slot (must exist in the company).

withWaitlistboolean

Activate or deactivate the waitlist for the slot.

hideAttendeesboolean

Hide the list of attendees in the calendar event. Only available when an Outlook calendar integration is enabled for the classroom's group.

Example request

{
  "reportedDuration": 1,
  "maxCapacity": 10,
  "name": "My awesome classroom slot",
  "context": {
    "_id": "507f1f77bcf86cd799439011"
  },
  "location": "https://meet.google.com/kdf-zkfz-hje",
  "trainerIds": [
    "507f1f77bcf86cd799439011"
  ],
  "mediaIds": [
    "507f1f77bcf86cd799439011"
  ],
  "timezone": "Europe/Paris",
  "authorId": "507f1f77bcf86cd799439011"
}

Response

Returns the created classroom slot.

startDatestring date-time required

The date and time when the classroom slot starts (must be before endDate), in the YYYY-MM-DDThh:mm:ss.sssZ format (ISO 8601 in Coordinated Universal Time (UTC)).

endDatestring date-time required

The date and time when the classroom slot ends (must be after startDate), in the YYYY-MM-DDThh:mm:ss.sssZ format (ISO 8601 in Coordinated Universal Time (UTC)).

reportedDurationnumber required

The reported duration of the slot, in hours.

virtualboolean required

True when the slot is a virtual classroom, false otherwise.

maxCapacitynumber

The maximum number of registrations allowed in the slot. Learners won't be able to self-enroll on this slot if this number is reached.

_idstring ObjectId required

The unique ID of the classroom slot.

classroomIdstring ObjectId required

The unique ID of the classroom the slot is linked to.

createdAtstring date-time

The date and time when the classroom slot has been created, in the YYYY-MM-DDThh:mm:ss.sssZ format (ISO 8601 in Coordinated Universal Time (UTC)).

namestring required

The title of the classroom slot.

locationstring required

The location of the classroom slot, being either a URL or a physical address.

trainerIdsstring[] required

The list of unique user IDs of trainers in charge of the slot (users must exist in the company).

mediaIdsstring[] required

The list of medias unique identifiers linked to the classroom slot.

modifiedAtstring date-time

The date and time when the classroom slot has been updated, in the YYYY-MM-DDThh:mm:ss.sssZ format (ISO 8601 in Coordinated Universal Time (UTC)).

timezonestring

The timezone of the slot in the format Continent[/Country]/City defined by TZ database.

webinarProviderstring

If the classroom is setup through a webinar integration, contains the name of the integration.

hideAttendeesboolean

Whether the list of attendees is hidden in the calendar event.

Example response

{
  "reportedDuration": 1,
  "maxCapacity": 10,
  "_id": "507f1f77bcf86cd799439011",
  "classroomId": "507f1f77bcf86cd799439011",
  "name": "My awesome classroom slot",
  "location": "https://meet.google.com/kdf-zkfz-hje",
  "trainerIds": [
    "507f1f77bcf86cd799439011"
  ],
  "mediaIds": [
    "507f1f77bcf86cd799439011"
  ],
  "timezone": "Europe/Paris",
  "webinarProvider": "Microsoft Teams",
  "context": {
    "_id": "507f1f77bcf86cd799439011"
  }
}

Changes

  • d827a4a84180Revision changes
    • breaking

      added subschema #1: Classroom Slot Waitlist Not Active subschema #2: Classroom Slot Waitlist Not Allowed subschema #6: Author Not Allowed subschema #7: Hide Attendees Not Active subschema #8: Hide Attendees Requires Outlook Calendar to the response body oneOf list for the response status

    • breaking

      added subschema #1: User Not Found to the response body oneOf list for the response status

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status