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
Headers
Body
Response
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"
}