API ReferenceComputer

Deploy a computer asset to a preview URL

Beta
Deploy a computer asset's running application to a shareable, persistent preview URL — the same action the Deploy button in the Olympus UI performs. Auto-starts the computer if it is stopped, validates that the requested port is reachable, records the deployment in the asset's metadata (so the UI stays in sync), and returns the Marathon preview URL for the exposed port. Call it with different ports to deploy multiple services from the same computer.

Authentication

X-API-KEYstring
API Key authentication via header
OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

asset_idstringRequired

Request

This endpoint expects an object.
portintegerOptional1-65535Defaults to 3000
Port inside the computer to expose publicly. Defaults to 3000. Each port gets its own deterministic preview subdomain, so you can deploy multiple services from the same computer by calling this endpoint with different ports.

Response

Successful Response
deployed_portslist of integers
All ports currently deployed for this computer asset.
portinteger
Port that was deployed and exposed on the preview URL.
urlstring

Persistent Marathon preview URL for the deployed port (https://{uuid}—{port}.{marathon_app_domain}). Does not expire.

Errors

401
Unauthorized Error
404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error
502
Bad Gateway Error