Docs home

Update Session

Edits or reschedules a session created with "Create Session". Put the session's `attendance_id` in the URL. You can change just this session, this and all later sessions in the series, or the sessions in a date range.

POST/schedule/version/session/{attendance_id}
Update Session
curl --request POST \
  --url 'https://<your-api-host>/nuSource/api/v1/schedule/version/session/{attendance_id}' \
  --header 'APIKEY: <your-api-key>' \
  --header 'ORGID: <your-org-id>' \
  --form 'JSONString={"class_name":"Physics - Motion and Laws | Normal Session - Updated","class_date":"09 Mar 2026","start_time":"00:30","end_time":"1:30 AM","tutor_id":"1687","scheduled_notification":1,"reminder_notification":1,"zoom_room_waiting":false,"is_sharable_link_enabled":true,"can_join_without_login":true,"topics":"<p>Topic</p>","class_type":3,"feedback_form_id":"","s_hour":0,"s_minute":30,"e_hour":"1","e_minute":"30","send_sms":1,"virtual_class_type":1,"attendance_id":"48928","exam_type":null,"update_type":0,"force_schedule":1,"is_live":1}'
{
  "code": 200,
  "message": "Updated Successfully",
  "attendance_details": {
    "attendance_id": [
      48928
    ]
  }
}

Access: Institute admins and tutors, plus custom roles with scheduling write permission. Tutors can't edit batch-level sessions, and their changes to the session name, reminder and feedback form are not saved.

Request body: form-data with one field, JSONString, containing this JSON:

Path parameters
attendance_idintegerrequired
The session to edit.
BodyJSONString
class_datestringYes, unless update_type is 1
New date, as D Mon YYYY (for example 20 Jul 2026). Only applied when editing a single session.
s_hourintegerrequired
Start hour, 0-23, in your timezone.
s_minuteintegerrequired
Start minute.
e_hourintegerrequired
End hour, 0-23. If the end is earlier than the start, the session ends the next day.
e_minuteintegerrequired
End minute. Start and end cannot be the same.
0 this session only (default), 1 this and all later sessions of the series that have not started, 2 the series' sessions between update_date_start and update_date_end. When several sessions change, each keeps its own date and only the time and settings change.
update_date_startstringYes if update_type is 2
First date of the range, for example 2026-07-01.
update_date_endstringYes if update_type is 2
Last date of the range.
1 changes only the date and time (plus link-sharing and optional flags) and leaves the tutor, topics and live settings as they are. Default 0.
tutor_idinteger
New tutor. Must be in your organization. Defaults to the current tutor.
topicsstring
Topics text. Defaults to the current text.
Session name.
is_liveinteger
1 live (online), 0 offline. Default 0, so send it again to keep a session live.
Only when live: 1 Zoom Meeting (default), 5 Zoom Webinar, 6 Custom Link.
1 turns on the Zoom waiting room.
1 marks Zoom attendees present only above a minimum share of the session.
That minimum share, 1-100.
false stops the "session rescheduled" notification. Default true.
Send a reminder before the session. Default true.
Feedback form attached to the session.
true lets people join through the shareable link without logging in. Must be JSON true/false.
1 marks the session as optional.
1 skips the tutor and student clash checks.
Response200application/json
codeinteger
Example: 200
messagestring
Example: Updated Successfully
Show child attributesHide child attributes

Notes:

  • Only sessions that have not started can be edited ("You cannot edit a class that has already started."). Sessions made with the older scheduler fail with "Sessions scheduled from the older Admin dashboard cannot be edited in the new Admin dashboard."
  • Unless force_schedule is 1, the request fails with code 5010 if the tutor is busy or 5011 if students have another session then.
  • When the date, time or shareable-link setting changes, students (and, by your settings, parents, tutor and admins) are notified by email, SMS or app notification. If your institute has a "session updated" webhook, it is sent with the changed session IDs.
  • Rate limit: 100 requests per minute; going over locks you out for 30 minutes.

Updated yesterday

Ask AI