swarmtix_talks_delete
Permanently deletes a talk of an unpublished online event that nobody has ordered
swarmtix_talks_delete
Permanently deletes a talk of an online event, with its speaker and category links and its video settings. This cannot be undone.
When you would reach for it
- Dropping a session from the schedule.
Scope
events:write
The connection's user must be allowed to edit the event, and the event must be an online event.
The event must be unpublished.
This tool is marked destructive and is not idempotent. A second call finds nothing to delete and is refused.
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. |
Example call
{
"name": "swarmtix_talks_delete",
"arguments": {
"event": "spring-summit-online",
"talk": "f07b0000-0000-0000-0000-000000000000"
}
}What comes back
{ "deleted": "f07b0000-0000-0000-0000-000000000000" }What happens when you call it
- The event is resolved through the edit gate and must be an online event.
- A published event is refused.
- The talk must be on this event, must not run as a Zoom live session, and must have no attendee data: no order for it and no chat in it.
- The talk and its links and video settings are deleted.
The event's start is not cleared when the last talk is deleted. swarmtix_event_readiness reports NoTalks in that case.
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".
"event is not valid: it is published, so a talk cannot be deleted."
Deleting is refused while the event is published. Unpublish it first with swarmtix_events_unpublish, then try again.
"... someone has ordered it or written in its chat."
A talk with attendee data cannot be deleted. Keep it, or change it with swarmtix_talks_update.
"This talk runs as a Zoom live session. ..."
Delete it in the Swarmtix dashboard.
Use cases
- Cleaning up a draft schedule