---
title: "Update web server settings"
method: PUT
path: "/api/web-server"
tags: ["Engine"]
---

# Update web server settings

`PUT /api/web-server`

Updates only the web server port

## Request body

- EngineWebServerCommandDTO — Engine web server command Data Transfer Object. Used as the request body for updating only the web server port.
  - `port` number, double, required — The port on which the engine listens.

## Response `200`

Engine web server settings updated successfully

- EngineSettingsUpdateResultDTO — Engine settings update result Data Transfer Object. Returned after updating engine settings to indicate if a redirect is needed.
  - `needsRedirect` boolean, required — Whether the client needs to redirect due to a port change.
  - `newPort` number, double, nullable, required — The new port to redirect to, if applicable.

## Changes

- **2026-07-20** `6a232346b158` — 1 info
  - endpoint added
- **2026-07-15** `57cbe043ec5a` — 1 breaking
  - api path removed without deprecation
- **2026-07-06** `4c50d4a73f66` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/optimistiksas/apis/oibus-api/changes/api/web-server/put.md)

---

[API](https://skmtc.dev/optimistiksas/apis/oibus-api.md) · [All operations](https://skmtc.dev/optimistiksas/apis/oibus-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/optimistiksas/oibus-api/revisions/d3abecc48b97/schema)