Skip to main content
POST
/
v1
/
admin
/
chats
curl -X POST https://portal-api.7331.org/v1/admin/chats \
  -H "Content-Type: application/json" \
  -b "psession=YOUR_SESSION" \
  -d '{"name": "General", "slug": "general", "description": "Official general chat"}'

{
  "chat_id": 1,
  "chat_name": "General",
  "username": "owner_user",
  "browser": "firefox",
  "allow_control_requests": false,
  "visibility": "official",
  "label": null,
  "slug": "general",
  "description": "Official general chat",
  "avatar_source": null,
  "running": false,
  "viewer_count": 0
}

Documentation Index

Fetch the complete documentation index at: https://docs.7331.org/llms.txt

Use this file to discover all available pages before exploring further.

Requires Owner permission level.
Creates an OFFICIAL chat owned by the requesting admin. OFFICIAL chats are publicly visible and pinned in the lobby. Use POST /portal/chats to create PRIVATE chats (requires premium or Admin+). Chat slots still apply — Admin users are capped at their configured chat slot limit; Owner is unlimited.

​
Request Body

​
name
string
required
Chat display name. 2–64 characters.
​
slug
string
required
URL slug for the chat — required because OFFICIAL chats are always public. 2–32 characters, lowercase alphanumeric and hyphens.
​
description
string
Chat description. Max 500 characters.
​
allow_control_requests
boolean
default:"false"
Whether viewers can request VM control.
​
browser_config
object
Neko container configuration.

​
Response

Returns the created chat’s live state (ChatStatusResponse).
​
chat_id
integer
required
Chat ID. Use this in all subsequent API calls.
​
chat_name
string
required
Display name.
​
username
string
required
Owner’s username.
​
browser
string
required
Browser type.
​
allow_control_requests
boolean
required
Whether viewers can request control.
​
visibility
string
required
"official"
​
slug
string | null
Vanity slug.
​
running
boolean
required
Always false on creation.
​
viewer_count
integer
required
Always 0 from REST.
curl -X POST https://portal-api.7331.org/v1/admin/chats \
  -H "Content-Type: application/json" \
  -b "psession=YOUR_SESSION" \
  -d '{"name": "General", "slug": "general", "description": "Official general chat"}'

{
  "chat_id": 1,
  "chat_name": "General",
  "username": "owner_user",
  "browser": "firefox",
  "allow_control_requests": false,
  "visibility": "official",
  "label": null,
  "slug": "general",
  "description": "Official general chat",
  "avatar_source": null,
  "running": false,
  "viewer_count": 0
}
The browser VM is not started automatically. Use Start Browser to launch it.