events/update-venue changes a venue in place. Only the fields you send are touched.
Every event linked to the venue picks the change up immediately, because events store the ID and nothing else.
At a glance
| Ability | events/update-venue |
| Toolset | The Events Calendar — toolset/events-calendar |
| Group | The Events Calendar › Venues |
| Requires | The Events Calendar, active on the site |
| Capability | manage_options |
| Safety | Writes data |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
How it works
This is the useful property of the calendar’s venue model: correct an address once and every past and future event at that venue is corrected. Nothing is copied at save time, so nothing goes stale.
It is also the trap. Editing a venue rewrites history — an event from two years ago now shows the new address, which is wrong if the venue moved rather than being mistyped. When a venue genuinely relocates, create a new one and point future events at it.
Partial updates are the default. Sending only phone leaves the address alone, so there is no need to read the record and send it back in full.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
id | integer | Yes | The venue ID. |
title | string | No | The venue name. |
status | string | No — defaults to draft | Post status: draft, publish, pending or private. |
address | string | No | Street address. |
city | string | No | City. |
state | string | No | State or province. |
zip | string | No | Postal code. |
country | string | No | Country. |
phone | string | No | Phone number. |
website | string | No | Website URL. |
What comes back
| Name | Type | What it is |
|---|---|---|
venue | object | The venue after the write. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
Update venue 204 with the new phone number.
It resolves to one call:
{
"ability": "events/update-venue",
"parameters": {
"id": 204,
"phone": "+44 117 496 0000"
}
}Worth knowing
- Idempotent. Applying the same values twice changes nothing the second time.
- To clear a field, send an empty string. Omitting it leaves the existing value.
- A correction applies retroactively to every event at this venue. A relocation should be a new venue.
Related abilities
- Get Venue — read the current values
- List Events — see which events this affects
- Create Venue — for a genuine relocation
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category