--- updatedAt: 2026-04-20T20:26:21.000Z agentTools: projectIndex: https://docs.wistia.com/llms.txt --- # Update Webinar Updates an existing webinar. ## Requires api token with one of the following permissions ``` Read, update & delete anything ``` Tokens with the "Act with a team member's permissions" permission (`all:delegate_to_contact_permissions` scope) can also be used. Requests made with such a token are authorized using the permissions of the contact assigned to the token. An [expiring access token](https://docs.wistia.com/reference/post_expiring-token) created with the `all:delegate_to_contact_permissions` scope and an authorization granting the `update` permission on this webinar can also be used. The `update` permission also allows registering attendees and managing the webinar's collaborators. # OpenAPI definition ````json { "openapi": "3.1.1", "info": { "title": "Data API", "description": "Wistia Data API", "version": "2026.09.0" }, "servers": [ { "url": "https://api.wistia.com/modern" } ], "security": [ { "BearerAuth": [] } ], "tags": [ { "name": "Webinars" } ], "paths": { "/webinars/{id}": { "put": { "summary": "Update Webinar", "x-speakeasy-group": "webinars", "x-speakeasy-name-override": "update", "description": "Updates an existing webinar.\n\n## Requires api token with one of the following permissions\n```\nRead, update & delete anything\n```\n\nTokens with the \"Act with a team member's permissions\" permission\n(`all:delegate_to_contact_permissions` scope) can also be used. Requests\nmade with such a token are authorized using the permissions of the\ncontact assigned to the token.\n\nAn [expiring access token](https://docs.wistia.com/reference/post_expiring-token)\ncreated with the `all:delegate_to_contact_permissions` scope and an\nauthorization granting the `update` permission on this webinar can also\nbe used. The `update` permission also allows registering attendees and\nmanaging the webinar's collaborators.\n", "parameters": [ { "name": "id", "in": "path", "description": "The hashed ID of the webinar", "required": true, "schema": { "type": "string" } }, { "name": "X-Wistia-API-Version", "in": "header", "required": true, "schema": { "type": "string", "default": "2026-09" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "webinar": { "unevaluatedProperties": false, "type": "object", "properties": { "title": { "description": "The title of the webinar", "type": "string", "examples": [ "Updated Webinar Title" ] }, "description": { "description": "The description of the webinar", "type": "string", "examples": [ "Updated webinar description" ] }, "scheduled_for": { "description": "The scheduled start time as a UTC formatted ISO 8601 string (offset `Z` or `+00:00`).", "type": "string", "format": "date-time", "examples": [ "2024-03-20T15:30:00Z" ] }, "event_duration": { "description": "Duration of the webinar in minutes (minimum 15)", "type": "integer", "examples": [ 90 ], "minimum": 15 }, "time_zone": { "description": "The IANA time zone identifier the webinar is scheduled in.", "type": "string", "examples": [ "America/New_York" ] }, "folder_id": { "description": "Hashed ID of the folder to move this webinar to. Can only be changed before the webinar has started.", "type": "string", "examples": [ "abc123def456" ] } } } } } } } }, "responses": { "200": { "description": "Webinar updated successfully", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "description": "A webinar is an event which allows you to stream a video\nto multiple participants. See our [Webinars Guide](https://support.wistia.com/en/articles/8288501-getting-started-with-webinars)\nfor more info.\n", "properties": { "id": { "description": "The hashed ID of the webinar", "type": "string", "examples": [ "abc123def456" ] }, "hashed_id": { "description": "The hashed ID of the webinar. Identical to `id`, named to match every other Wistia resource.", "type": "string", "examples": [ "abc123def456" ] }, "title": { "description": "The title of the webinar", "type": "string", "examples": [ "Wellness Session: Coping with Outie Memories" ] }, "description": { "description": "The description of the webinar", "type": [ "string", "null" ], "examples": [ "A comprehensive session on managing work-life balance" ] }, "scheduled_for": { "description": "The scheduled start time in W3C format with timezone", "type": [ "string", "null" ], "format": "date-time", "examples": [ "2024-03-20T15:30:00-05:00" ] }, "event_duration": { "description": "Duration of the webinar in minutes", "type": [ "integer", "null" ], "examples": [ 60 ] }, "time_zone": { "description": "The IANA time zone identifier the webinar is scheduled in", "type": "string", "examples": [ "America/New_York" ] }, "lifecycle_status": { "description": "The current lifecycle status of the webinar. This is a read-only, system-managed field that Wistia updates as the event moves through its lifecycle; it cannot be set or changed via the API.", "type": "string", "readOnly": true, "enum": [ "pending", "ready", "starting", "started", "ended", "vod_ready", "failed" ], "examples": [ "ready" ] }, "registration_status": { "description": "Registration status of the event", "type": "string", "examples": [ "published" ] }, "created_at": { "description": "When the event was created (UTC)", "type": "string", "format": "date-time", "examples": [ "2024-03-15T10:30:00Z" ] }, "updated_at": { "description": "When the event was last updated (UTC)", "type": "string", "format": "date-time", "examples": [ "2024-03-15T10:30:00Z" ] }, "audience_link": { "description": "Link for the audience to join the event", "type": "string", "examples": [ "https://lumon-industries.wistia.com/live/events/abc123def456" ] }, "host_link": { "description": "Link for the host to manage the event", "type": "string", "examples": [ "https://lumon-industries.wistia.com/live/events/abc123def456/onair" ] }, "panelist_link": { "description": "Link for panelists to join the event", "type": "string", "examples": [ "https://lumon-industries.wistia.com/live/events/abc123def456/onair/a1b2c3d4-e5f6-7890-abcd-ef1234567890" ] }, "thumbnail_url": { "description": "URL of the webinar's custom thumbnail image, or null if no custom thumbnail has been set", "type": [ "string", "null" ], "examples": [ "https://embed-ssl.wistia.com/deliveries/abc123def456.jpg" ] }, "folder": { "description": "The folder (project) this webinar belongs to", "unevaluatedProperties": false, "oneOf": [ { "unevaluatedProperties": false, "type": "object", "properties": { "id": { "description": "A unique alphanumeric identifier for the record.", "type": "string" }, "index_url": { "description": "A URL for fetching all the records of the given record type. You can pass hashed_ids as a param with multiple values\nto do a batch fetch for this records type.\n", "type": "string" }, "url": { "description": "A URL that can be used to fetch this record.", "type": "string" } }, "required": [ "id", "index_url", "url" ] }, { "type": "null" } ] }, "cursor": { "description": "A cursor for stable pagination based on current `sort_by` order. You can pass this to `cursor[before]` or `cursor[after]` as a parameter to fetch the records before or after this record in the same sort order. This is only populated if records were fetched with `cursor[enabled]`, or `cursor[before]` or `cursor[after]`.", "type": [ "string", "null" ] } }, "required": [ "id", "hashed_id", "title", "time_zone", "lifecycle_status", "registration_status", "created_at", "updated_at", "audience_link", "host_link", "panelist_link" ] } } } }, "401": { "description": "Unauthorized, invalid or missing token", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "code": { "description": "A machine-readable identifier for the specific authorization failure.", "type": "string", "enum": [ "unauthorized_credentials", "account_inactive", "unauthorized_scope", "unauthorized_params" ] }, "error": { "type": "string", "examples": [ "Invalid credentials." ] } } } } } }, "403": { "description": "Webinar feature not available", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "error": { "type": "string", "examples": [ "Webinars are not available on your current plan" ] } } } } } }, "404": { "description": "Webinar not found" }, "422": { "description": "Validation errors", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "errors": { "type": "array", "items": { "type": "string" }, "examples": [ [ "Title is required", "Event duration must be at least 15 minutes" ] ] } } } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "error": { "type": "string", "examples": [ "Internal server error" ] } } } } } } }, "tags": [ "Webinars" ], "x-readme": { "code-samples": [ { "name": "Typescript (SDK)", "language": "javascript", "code": "import { Wistia } from \"@wistia/wistia-api-client\";\n\nconst wistia = new Wistia({\n bearerAuth: process.env[\"WISTIA_BEARER_AUTH\"] ?? \"\",\n});\n\nasync function run() {\n const result = await wistia.webinars.update({\n id: \"\",\n requestBody: {\n webinar: {\n title: \"Updated Webinar Title\",\n description: \"Updated webinar description\",\n scheduledFor: new Date(\"2024-03-20T15:30:00-05:00\"),\n eventDuration: 90,\n timeZone: \"America/New_York\",\n folderId: \"abc123def456\",\n },\n },\n });\n\n console.log(result);\n}\n\nrun();" } ] } } } }, "components": { "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer" } } }, "x-readme": { "samples-languages": [ "javascript", "shell", "node", "python", "ruby" ] } } ````