Skip to main content
PUT
Set the startup command

Authorizations

Authorization
string
header
required

A Cool Computers API key, user access token, or claimed agent access token in the Authorization header. Follow https://www.cool.computer/auth.md for agent registration and https://www.cool.computer/authentication.md for direct user credentials.

Path Parameters

id
string
required

Stable public computer identifier.

Minimum string length: 1
Example:

"cmp_123"

Body

application/json
command
string
required
Minimum string length: 1
port
integer
required

HTTP port to expose after the command starts. Platform ports 3129, 8080 and 18080 are reserved.

Required range: 1 <= x <= 65535
cwd
string
default:/home/runtime/app

Absolute path to an existing directory, reached without symlinks, used to start the service; anything else answers 400 invalid_cwd. Omit it to use /home/runtime/app, created if missing, which status then reports. /, /home and /home/runtime hold credentials and are refused with 400, a guard against serving them by mistake rather than a security boundary.

Response

The saved startup command.

configured
boolean
required
command
string
cwd
string
port
integer
Required range: 1 <= x <= 65535