update_server
Update a server's deploy configuration or metadata, optionally redeploying immediately.
Updates a server's deploy configuration (start command, build command, port, Dockerfile path, root dir) and/or metadata (name, description, tags, production branch).
Deploy-config fields are merged into the existing configuration, only the fields you pass change, the rest are preserved. Config changes don't take effect until the next deployment, so pass redeploy: true to trigger one immediately.
A common use: fix a broken start command (for example, set startCommand to a uvicorn command for a Python MCP server) and redeploy in one call.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
organizationId | string | Yes | The organization that owns the server. From list_organizations. |
serverId | string | Yes | The server to update. From list_servers. |
startCommand | string | No | Process start command for the deploy pipeline. |
buildCommand | string | No | Build command. Pass an empty string to clear it. |
port | number | No | Application port the server listens on (1–65535). |
dockerfilePath | string | No | Path to a non-default Dockerfile, relative to the root dir. |
rootDir | string | No | Repository subdirectory to build from. |
name | string | No | Server display name. |
description | string | No | Server description. |
tags | string[] | No | Replacement set of server tags. |
productionBranch | string | No | Git branch deployed for the production environment. |
redeploy | boolean | No | When true, trigger a new deployment after saving (default false). |
Returns
The updated server, plus the new deployment when redeploy is true.