Skip to main content
POST
/
v1
/
bot
/
users
/
{user_id}
/
update
curl -X POST https://portal-api.7331.org/v1/bot/users/42/update \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-bot-api-key" \
  -d '{"username": "newusername"}'

{
  "id": 42,
  "username": "newusername",
  "avatar_url": null,
  "subscription_tier": 0,
  "permission_level": 0,
  "state": 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.

​
user_id
integer
required
User ID.
​
X-API-Key
string
required
Bot API key.
​
username
string
Username (3-32 chars: alphanumeric, dots, underscores, hyphens).

​
Response

Returns the updated user profile (UserBotResponse).
​
id
integer
required
User ID.
​
username
string
required
Username.
​
avatar_url
string
Platform avatar URL. May be null.
​
subscription_tier
integer
required
Current subscription level. 0 = Basic, 1 = Trial, 2 = Premium, 3 = Lifetime.
​
permission_level
integer
required
Permission level. 0 = User, 1 = Moderator, 2 = Admin, 3 = Owner.
​
state
integer
required
User state. 0 = Active, 1 = Timeout, 2 = Banned.
curl -X POST https://portal-api.7331.org/v1/bot/users/42/update \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-bot-api-key" \
  -d '{"username": "newusername"}'

{
  "id": 42,
  "username": "newusername",
  "avatar_url": null,
  "subscription_tier": 0,
  "permission_level": 0,
  "state": 0
}