Skip to content

EventUpdate

Changes to an event; an omitted field keeps its value, and places replaces every place. A new date (starts_at and ends_at together) is checked as a new event’s; on an unscheduled event, it fixes the date without a candidate and ends the date poll.

object
title
string
description
string
visibility

Who sees an event: public every local user, followers the users who follow the organizer, following the users the organizer follows, mutuals the users who follow the organizer and whom the organizer follows, and invited the invited users only. The organizer, the co-organizers, the invited users, and the users who answered always see it, unless a block separates them from the organizer or a co-organizer.

string
Allowed values: public followers following mutuals invited
time_zone
string
place_disclosure

Who sees the physical and url places of an event: approved only the attendees whom the organizer or a co-organizer approved, and viewers everyone who sees the event. The organizer and the co-organizers see them always, and a voice place is shown to everyone who sees the event.

string
Allowed values: approved viewers
capacity
integer
board_writers

Who posts on the event’s board; only the organizer changes it.

string
Allowed values: organizer organizers readers
places
Array<object>

A place of an event. A physical place has a name, an address, and an optional map link in url; a url place has a name and a url; a voice place has speakers, who may speak without asking in the voice chat room that opens when the event starts. A URL is an http or https URL of up to 2,000 characters, which the server never fetches. The fields that a kind does not have are omitted.

object
kind
required

The kind of a place: voice a voice chat room of this server, physical a place to meet in person, and url a link such as a stream or a meeting of another service.

string
Allowed values: voice physical url
name

Up to 100 characters on one line.

string
address

Up to 500 characters; line breaks are kept.

string
url
string
speakers

Who may speak without asking in the room; manual when omitted.

string
Allowed values: everyone followers following mutuals manual
room_id

For a voice place, the voice chat room that the start of the event’s current date opened (GET /voice/rooms/{id}), which may have ended since; omitted before the room opens. Ignored in a request.

string format: uuid
room_unavailable

For a voice place, why the room of the event’s current date could not open at the start; omitted otherwise. Ignored in a request.

string
Allowed values: disabled not_eligible too_many_rooms hosting_elsewhere
starts_at
string format: date-time
ends_at
string format: date-time

Example generated

{
"title": "example",
"description": "example",
"visibility": "public",
"time_zone": "example",
"place_disclosure": "approved",
"capacity": 1,
"board_writers": "organizer",
"places": [
{
"kind": "voice",
"name": "example",
"address": "example",
"url": "example",
"speakers": "everyone"
}
],
"starts_at": "2026-04-15T12:00:00Z",
"ends_at": "2026-04-15T12:00:00Z"
}

For LLMs and coding agents:llms.txt,llms-full.txt, llms-small.txt

Analytics on this site