Skip to main content
POST
/
v1
/
authentication
/
request
curl -X POST https://portal-api.7331.org/v1/authentication/request \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-public-api-key" \
  -d '{"platform": "discord", "platform_user_id": "123456789012345678"}'

{
  "message": "Login code generated.",
  "expires_at": "2025-01-01T00:10: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.

Web-initiated login. Generates a code bound to the user’s IP, then the bot fetches it and DMs it to the user. Works for both new signups and existing users. Requires X-API-Key header with the public API key.
​
platform
string
required
Platform identifier (e.g. discord).
​
platform_user_id
string
required
Platform-specific user ID for authentication.

​
Response

​
message
string
required
Human-readable status message.
​
expires_at
string
When the login code expires (UTC).
curl -X POST https://portal-api.7331.org/v1/authentication/request \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-public-api-key" \
  -d '{"platform": "discord", "platform_user_id": "123456789012345678"}'

{
  "message": "Login code generated.",
  "expires_at": "2025-01-01T00:10:00Z"
}
Each IP address can have at most 5 pending login codes at a time. If you hit this limit, wait for existing codes to expire (10 minutes) or verify them before requesting new ones.