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

{
  "id": 42,
  "chat_type": "group",
  "name": "my-chat",
  "owner": { "id": 7, "username": "cool_fox_123", "avatar_url": null },
  "visibility": "private",
  "label": null,
  "slug": null,
  "description": null,
  "avatar_url": null,
  "archived": false
}

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.

Creates a new PRIVATE group chat. Requires an active premium subscription (or ADMIN+ permission level) with an available chat slot. To create an OFFICIAL or PUBLIC chat, use the admin_tools.py CLI.
​
name
string
required
Chat display name. 2–64 characters.
​
description
string
Optional 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 object (ChatStatusResponse).
​
id
integer
required
Chat ID. Use this in all subsequent API calls.
​
chat_type
string
required
Always "group" for newly created chats.
​
name
string
required
Chat display name.
​
owner
object | null
required
Owner identity. Always populated for GROUP chats; null for SECRET_GROUP and SECRET_CHAT (not applicable here).
​
visibility
string
required
Always "private" for user-created chats.
​
label
string | null
Platform endorsement label. Always null at creation.
​
slug
string | null
Vanity slug. Always null for new private chats.
​
description
string | null
Chat description.
​
avatar_url
string | null
Resolved avatar URL. null at creation.
​
archived
boolean
required
Always false on creation.
curl -X POST https://portal-api.7331.org/v1/portal/chats \
  -H "Content-Type: application/json" \
  -b "psession=YOUR_SESSION" \
  -d '{"name": "my-chat", "allow_control_requests": true}'

{
  "id": 42,
  "chat_type": "group",
  "name": "my-chat",
  "owner": { "id": 7, "username": "cool_fox_123", "avatar_url": null },
  "visibility": "private",
  "label": null,
  "slug": null,
  "description": null,
  "avatar_url": null,
  "archived": false
}
The browser VM is not started automatically. Use Start Browser to launch it.