Skip to content

AdminEventRevision

A revision of the settings of an event with all its places. The title and the description are empty, and the places are gone, once the account that wrote them is erased.

object
id
required

The ID of a resource, a UUIDv7 in its canonical string form.

string format: uuid
title
required
string
description
required
string
visibility
required

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
required
string
place_disclosure
required

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
required

How many attendees may answer going; 0 for no limit.

integer
places
required
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
revised_by_account_id
required

The ID of a resource, a UUIDv7 in its canonical string form.

string format: uuid
revised_at
required
string format: date-time

Example generated

{
"id": "01890a5d-ac96-774b-bcce-b302099a8057",
"title": "example",
"description": "example",
"visibility": "public",
"time_zone": "example",
"place_disclosure": "approved",
"capacity": 1,
"places": [
{
"kind": "voice",
"name": "example",
"address": "example",
"url": "example",
"speakers": "everyone"
}
],
"revised_by_account_id": "01890a5d-ac96-774b-bcce-b302099a8057",
"revised_at": "2026-04-15T12:00:00Z"
}

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

Analytics on this site