Set HTTP API port

PUT

/api/v1/settings/http-api-port

Change the HTTP API port in config. Requires app restart to take effect.

Query Parameters

port*Port

Port number (1-65535)

Successful Response

application/json

success*Success

Whether the operation succeeded

changed*Changed

Whether the setting was actually changed

message?|

Optional status message

Example Request

curl -X PUT 'http://127.0.0.1:8100/api/v1/settings/http-api-port?port=0'

Example Request

curl -X PUT 'http://127.0.0.1:8100/api/v1/settings/http-api-port?port=0'

Example ResponseSchema

{
  "success": true,
  "changed": true,
  "message": "string"
}

{  "success": true,  "changed": true,  "message": "string"}

Enable/disable HTTP API PUT

Toggle the HTTP API server on or off in config. Requires app restart to take effect.

Get MCP agent-voice settings GET

Return the default agent voice/model, the MCP endpoint URL, and the OpenAI-compatible TTS base URL.