Skip to main content
POST
/
v1
/
admin
/
bots
curl -X POST https://portal-api.7331.org/v1/admin/bots \
  -H "Content-Type: application/json" \
  -b "psession=YOUR_SESSION" \
  -d '{
    "name": "My Bot",
    "owner_id": 42,
    "platform": "discord",
    "rate_limit_per_hour": 1000
  }'

{
  "message": "Bot registered successfully",
  "bot": {
    "id": 5,
    "name": "My Bot",
    "platform": "discord",
    "owner_id": 42,
    "bot_type": 3,
    "is_active": true,
    "rate_limit_per_hour": 1000,
    "groups": 0,
    "users": 0,
    "avatar_url": null,
    "latency_ms": null,
    "is_verified": false,
    "last_activity_at": null,
    "created_at": "2026-01-15T12:00:00Z",
    "updated_at": "2026-01-15T12:00:00Z"
  },
  "api_key": "hbot_abc123def456...",
  "created_at": "2026-01-15T12:00:00Z",
  "updated_at": "2026-01-15T12:00:00Z"
}

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 an active admin session cookie.
​
name
string
required
Bot display name (2-32 characters).
​
owner_id
integer
required
User ID of bot owner.
​
platform
string
required
Platform this bot operates on (e.g. discord, telegram).
​
rate_limit_per_hour
integer
default:"1000"
Maximum API requests allowed per hour.

​
Response

​
message
string
required
Success message.
​
bot
object
required
Registered bot information. See Get Bot Profile.
​
api_key
string
required
Bot API key. Store securely - only shown once.
The api_key is only returned in this response. Make sure to save it securely.
curl -X POST https://portal-api.7331.org/v1/admin/bots \
  -H "Content-Type: application/json" \
  -b "psession=YOUR_SESSION" \
  -d '{
    "name": "My Bot",
    "owner_id": 42,
    "platform": "discord",
    "rate_limit_per_hour": 1000
  }'

{
  "message": "Bot registered successfully",
  "bot": {
    "id": 5,
    "name": "My Bot",
    "platform": "discord",
    "owner_id": 42,
    "bot_type": 3,
    "is_active": true,
    "rate_limit_per_hour": 1000,
    "groups": 0,
    "users": 0,
    "avatar_url": null,
    "latency_ms": null,
    "is_verified": false,
    "last_activity_at": null,
    "created_at": "2026-01-15T12:00:00Z",
    "updated_at": "2026-01-15T12:00:00Z"
  },
  "api_key": "hbot_abc123def456...",
  "created_at": "2026-01-15T12:00:00Z",
  "updated_at": "2026-01-15T12:00:00Z"
}