3x-ui3x-ui

Settings

Panel configuration and user credentials. All endpoints live under /panel/api/setting and require a logged-in session or Bearer token.

Return every panel setting: web server, Telegram bot, subscription, security, LDAP. The full JSON blob that the Settings page edits.

POST
/panel/api/setting/all

Authorization

AuthorizationBearer <token>

API token from Settings → Security → API Token. Send as Authorization: Bearer <token>.

In: header

Response Body

application/json

curl -X POST "https://example.com/panel/api/setting/all"
{  "success": true,  "msg": "string",  "obj": null}

Return the computed default settings based on the request host. Useful to preview what a fresh install would use.

POST
/panel/api/setting/defaultSettings

Authorization

AuthorizationBearer <token>

API token from Settings → Security → API Token. Send as Authorization: Bearer <token>.

In: header

Response Body

application/json

curl -X POST "https://example.com/panel/api/setting/defaultSettings"
{  "success": true,  "msg": "string",  "obj": null}

Persist every setting at once. The body mirrors the shape returned by /all. Invalid values (bad ports, missing cert pairs, etc.) are rejected before write.

POST
/panel/api/setting/update

Authorization

AuthorizationBearer <token>

API token from Settings → Security → API Token. Send as Authorization: Bearer <token>.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/panel/api/setting/update" \  -H "Content-Type: application/json" \  -d '{}'
{  "success": true,  "msg": "string",  "obj": null}

Change the panel admin username and password. Requires the current credentials for verification. The session is refreshed with the new values on success.

POST
/panel/api/setting/updateUser

Authorization

AuthorizationBearer <token>

API token from Settings → Security → API Token. Send as Authorization: Bearer <token>.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/panel/api/setting/updateUser" \  -H "Content-Type: application/json" \  -d '{    "oldUsername": "admin",    "oldPassword": "admin",    "newUsername": "newadmin",    "newPassword": "newpass"  }'
{  "success": true,  "msg": "string",  "obj": null}

Restart the entire 3x-ui process after a 3-second grace period. The connection drops immediately; the panel comes back online ~5-10 seconds later.

POST
/panel/api/setting/restartPanel

Authorization

AuthorizationBearer <token>

API token from Settings → Security → API Token. Send as Authorization: Bearer <token>.

In: header

Response Body

application/json

curl -X POST "https://example.com/panel/api/setting/restartPanel"
{  "success": true,  "msg": "string",  "obj": null}

Test SMTP connection with stage-by-stage reporting (connect, auth, send). Returns structured result with stage and message.

POST
/panel/api/setting/testSmtp

Authorization

AuthorizationBearer <token>

API token from Settings → Security → API Token. Send as Authorization: Bearer <token>.

In: header

Response Body

application/json

curl -X POST "https://example.com/panel/api/setting/testSmtp"
{  "success": true,  "stage": "send",  "msg": "Test email sent successfully"}

Test Telegram bot connection by sending a test message to the configured chat.

POST
/panel/api/setting/testTgBot

Authorization

AuthorizationBearer <token>

API token from Settings → Security → API Token. Send as Authorization: Bearer <token>.

In: header

Response Body

application/json

curl -X POST "https://example.com/panel/api/setting/testTgBot"
{  "success": true,  "msg": "Test message sent to Telegram"}

Return the built-in default Xray JSON config template that ships with this panel version.

GET
/panel/api/setting/getDefaultJsonConfig

Authorization

AuthorizationBearer <token>

API token from Settings → Security → API Token. Send as Authorization: Bearer <token>.

In: header

Response Body

application/json

curl -X GET "https://example.com/panel/api/setting/getDefaultJsonConfig"
{  "success": true,  "msg": "string",  "obj": null}