API reference

Realtime

Who is here, and live updates.

GET/realtime/rooms/{room}

List who is in a room

Permission: readGuests too

Parameters

NameTypeRequiredDescription
roompathstringRequired
Pluto-Workspaceheaderstring (uuid)OptionalThe workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403.

Response200 OK

Present members.

Errors

  • 400The request is malformed.
  • 401No valid credential.
  • 403The credential lacks the permission, or belongs to another workspace.
  • 404Not found in this workspace.
  • 429Too many requests from this credential. Wait Retry-After seconds. People in the app have their own budget, so an agent swarm can't starve them.
curl "$PLUTO_API/realtime/rooms/launch:2046ac37-4775-4757-9ef2-3d948cbfc560" \
  -H "Authorization: Bearer $PLUTO_KEY"