Changes a talk of an online event, including its time, speakers, categories and video

swarmtix_talks_update

Changes a talk of an online event and returns it. Only the fields you give are changed.

When you would reach for it

Moving a talk to another time.
Changing the speakers or the video of a talk.

Scope

events:write

The connection's user must be allowed to edit the event, and the event must be an online event.

It is idempotent: sending the same arguments twice leaves the same talk, so a client may retry.

Parameters

Name	Type	Required	Default	Description
`event`	string	Yes	-	The event's id (a GUID) or its URL slug.
`talk`	string	Yes	-	The id of the talk, as returned by `swarmtix_online_program_get`.
`title`	string	No	keeps current	Up to 255 characters.
`startsAt`	string	No	keeps current	UTC, ISO 8601. Seconds are dropped.
`durationMinutes`	integer	No	keeps current	From 1 to 1,440.
`description`	string	No	keeps current	Basic HTML is kept. Up to 20,000 characters.
`speakerIds`	string[]	No	keeps current	Replaces the list. An empty list clears it. At most 50.
`categoryIds`	string[]	No	keeps current	Replaces the list. An empty list clears it. At most 50.
`videoType`	string	No	none	`"prerecorded"` or `"stream"`. Give it with `videoProvider` and `videoUrl`, all three or none.
`videoProvider`	string	No	none	Pre-recorded: `youtube`, `vimeo`, `wistia`, `dubb`, `vooplayer`, `bigmarker`, `hippovideo`, `custom`. Stream: `youtube`, `wistia`, `custom`.
`videoUrl`	string	No	none	An http or https URL, up to 2,000 characters.
`replayProvider`	string	No	none	The replay's provider, from the same list as pre-recorded. Give it with `replayUrl`.
`replayUrl`	string	No	none	An http or https URL, up to 2,000 characters.

Example call

{
  "name": "swarmtix_talks_update",
  "arguments": {
    "event": "spring-summit-online",
    "talk": "f07b0000-0000-0000-0000-000000000000",
    "startsAt": "2030-06-01T17:00:00Z"
  }
}

What comes back

The talk as stored after the change, in the same shape as swarmtix_talks_create.

What happens when you call it

The event is resolved through the edit gate and must be an online event.
Every given field is checked, and the talk must be on this event.
A talk that runs as a Zoom live session is refused.
Only the fields you gave are written. Moving the earliest talk moves the start of the event.

Troubleshooting

"Event not found, or this connection does not have access to it."

The event does not exist, it belongs to another organisation, or this organizer may read it but not edit it.

"This event is not an online event. Talks, speakers, categories and hosts belong to online events only. Nothing was changed."

The event is a physical event. These tools only work on events created with kind: "online".

"`talk` is not valid: there is no talk with that id on this event."

The id is not a talk of this event. Get the ids from swarmtix_online_program_get.

"This talk runs as a Zoom live session. Change or delete it in the Swarmtix dashboard, which keeps the Zoom meeting in step. Nothing was changed."

Any Zoom talk is refused by update and delete. Use the dashboard.

Use cases

Rescheduling a talk after a speaker change

swarmtix_talks_update

On this page