Deploy a computer asset to a preview URL | Athena

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. Ports reserved by the computer runtime (such as the internal developer-agent port) are rejected with a 400 and can never be deployed. A 409 means the port cannot be exposed on this computer’s runtime as currently booted (the detail explains how to proceed); a 502 means the runtime’s port validation failed.

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. Ports reserved by the computer runtime (such as the internal developer-agent port) are rejected with a 400 and can never be deployed. A 409 means the port cannot be exposed on this computer's runtime as currently booted (the detail explains how to proceed); a 502 means the runtime's port validation failed.

Authentication

X-API-KEYstring

API Key authentication via header

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

$	curl -X POST https://api.athenaintel.com/api/v0/computer/asset_id/deploy \
>	-H "X-API-KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"port": 3000
>	}'

1	{
2	"deployed_ports": [
3	3000,
4	8080
5	],
6	"port": 3000,
7	"url": "https://abc123--3000.app.athenaintel.com"
8	}