curl -X POST "https://app.runtm.com/api/cloud/sessions/ses_abc123/run-server" \
-H "Authorization: Bearer runtm_xxx" \
-H "Content-Type: application/json" \
-d '{"command": "npm run dev", "port": 3000}'
import requests
response = requests.post(
"https://app.runtm.com/api/cloud/sessions/ses_abc123/run-server",
headers={
"Authorization": "Bearer runtm_xxx",
"Content-Type": "application/json",
},
json={"command": "npm run dev", "port": 3000},
)
data = response.json()
print(f"Server running at {data['url']}")
const response = await fetch(
"https://app.runtm.com/api/cloud/sessions/ses_abc123/run-server",
{
method: "POST",
headers: {
"Authorization": "Bearer runtm_xxx",
"Content-Type": "application/json",
},
body: JSON.stringify({ command: "npm run dev", port: 3000 }),
}
);
const data = await response.json();
console.log(`Server running at ${data.url}`);
{
"session_id": "ses_abc123",
"command": "npm run dev",
"port": 3000,
"url": "https://ses-abc123-3000.runtm.dev"
}
Files
Run Server
Start a development server in the sandbox
POST
/
api
/
sessions
/
{session_id}
/
run-server
curl -X POST "https://app.runtm.com/api/cloud/sessions/ses_abc123/run-server" \
-H "Authorization: Bearer runtm_xxx" \
-H "Content-Type: application/json" \
-d '{"command": "npm run dev", "port": 3000}'
import requests
response = requests.post(
"https://app.runtm.com/api/cloud/sessions/ses_abc123/run-server",
headers={
"Authorization": "Bearer runtm_xxx",
"Content-Type": "application/json",
},
json={"command": "npm run dev", "port": 3000},
)
data = response.json()
print(f"Server running at {data['url']}")
const response = await fetch(
"https://app.runtm.com/api/cloud/sessions/ses_abc123/run-server",
{
method: "POST",
headers: {
"Authorization": "Bearer runtm_xxx",
"Content-Type": "application/json",
},
body: JSON.stringify({ command: "npm run dev", port: 3000 }),
}
);
const data = await response.json();
console.log(`Server running at ${data.url}`);
{
"session_id": "ses_abc123",
"command": "npm run dev",
"port": 3000,
"url": "https://ses-abc123-3000.runtm.dev"
}
Starts a development server process in the sandbox. The server runs in the background and its port becomes accessible via the sandbox URL.
Required scope:
sessions:write
Path Parameters
string
required
The session ID (e.g.
ses_abc123).Headers
string
required
Bearer token. Example:
Bearer runtm_xxxBody
string
required
Command to start the server (e.g.
npm run dev).integer
required
Port the server will listen on.
Response
string
Session ID.
string
Command that was started.
integer
Port the server is listening on.
string
Public URL to access the server.
curl -X POST "https://app.runtm.com/api/cloud/sessions/ses_abc123/run-server" \
-H "Authorization: Bearer runtm_xxx" \
-H "Content-Type: application/json" \
-d '{"command": "npm run dev", "port": 3000}'
import requests
response = requests.post(
"https://app.runtm.com/api/cloud/sessions/ses_abc123/run-server",
headers={
"Authorization": "Bearer runtm_xxx",
"Content-Type": "application/json",
},
json={"command": "npm run dev", "port": 3000},
)
data = response.json()
print(f"Server running at {data['url']}")
const response = await fetch(
"https://app.runtm.com/api/cloud/sessions/ses_abc123/run-server",
{
method: "POST",
headers: {
"Authorization": "Bearer runtm_xxx",
"Content-Type": "application/json",
},
body: JSON.stringify({ command: "npm run dev", port: 3000 }),
}
);
const data = await response.json();
console.log(`Server running at ${data.url}`);
{
"session_id": "ses_abc123",
"command": "npm run dev",
"port": 3000,
"url": "https://ses-abc123-3000.runtm.dev"
}