---
title: "Update Webinar Session"
method: PATCH
path: "/webinar/configuration/v1/webinars/{webinarId}/sessions/{sessionId}"
tags: ["Webinars and Sessions"]
---

# Update Webinar Session

`PATCH /webinar/configuration/v1/webinars/{webinarId}/sessions/{sessionId}`

Updates a Webinar Session. The payload may contain certain attributes from the Session resource
(it is a partial update). Changing the 'status' field usually invokes certain workflow actions.
Updating a Session in 'Active' or 'Finished' status is prohibited.
Some status transitions (for example, to 'Active" or 'Finished') may be prohibited.

## Request body

- WcsSessionWithLocaleCodeModel
  - `scheduledStartTime` string, date-time, required — Session scheduled start time.
  - `scheduledDuration` integer, required — The duration of the Session in seconds.
  - `timeZone` string, required — IANA-compatible time zone name (see https://www.iana.org/time-zones).
  - `localizedTimeZoneDescription` string — Localized time zone description.
  - `panelJoinTimeOffset` integer — The time offset (positive, in seconds) indicating how much in advance (comparing to "scheduledStartTime") panel members should join for the pre-webinar team sync
  - `title` string — Session title. Can be left blank - then Webinar title should be used for presentation.
  - `description` string — User-friendly description of the Session. Can be left blank - then Webinar title should be used for presentation.
  - `status` 'Scheduled' | 'Active' | 'Finished' — Session status (for the purposes of Configuration service)
  - `hostJoinUri` string, uri — The URI to join the webinar as a host
  - `localeCode` string — Session locale code. Can't be blank or null

## Response `200`

Successful response

- WcsSessionResource
  - `id` string — Internal object ID
  - `creationTime` string, date-time, required — Object creation time
  - `lastModifiedTime` string, date-time, required — Object last modification time
  - `scheduledStartTime` string, date-time, required — Session scheduled start time.
  - `scheduledDuration` integer, required — The duration of the Session in seconds.
  - `timeZone` string, required — IANA-compatible time zone name (see https://www.iana.org/time-zones).
  - `localizedTimeZoneDescription` string — Localized time zone description.
  - `panelJoinTimeOffset` integer — The time offset (positive, in seconds) indicating how much in advance (comparing to "scheduledStartTime") panel members should join for the pre-webinar team sync
  - `title` string — Session title. Can be left blank - then Webinar title should be used for presentation.
  - `description` string — User-friendly description of the Session. Can be left blank - then Webinar title should be used for presentation.
  - `status` 'Scheduled' | 'Active' | 'Finished' — Session status (for the purposes of Configuration service)
  - `hostJoinUri` string, uri — The URI to join the webinar as a host
  - `localeCode` string — Session locale code. Can't be blank or null
  - `videoBridgeId` string — The RCV bridge id
  - `videoBridgePassword` string, password — The RCV bridge password. Returned only if requested by Host/Co-host/Panelist and a password for the bridge is set.
  - `videoBridgePstnPassword` string, password — The RCV bridge PSTN password. Returned only if requested by Host/Co-host/Panelist and a PSTN password for the bridge is set.
  - `attendeeJoinUri` string, uri — The URI for attendees to join the Webinar (if it is a public webinar)
  - `hasUnsentInvites` boolean — Calculated attribute indicating if there are any unsent/deferred invites to session participants

## Other responses

- `400` — General response with **HTTP 400 "Bad request"** status.<br> Reasons: unparsable request, path, query or body parameters are invalid. The error description may contain reference to particular parameter(s) which haven't passed the validation.
- `403` — General response with **HTTP 403 "Forbidden"** status.<br> Reasons: the requested operation is forbidden because of certain resource state, lack of permissions, feature unavailability, etc.
- `404` — General response with **HTTP 404 "Not found"** status.<br> Reasons: the entity with given ID (typically specified in a path parameter), is not found or inaccessible
- `500` — General response with **HTTP 500 "Internal Server Error"** status.<br> Reasons: general server-side error.

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/versions/8d602198ec97/schema)