LogoFreestyle
API ReferenceDev servers

Request a Dev Server

POST
/ephemeral/v1/dev-servers

Request Body

application/json

devCommand?string|null
installCommand?string|null
timeout?integer|null
Formatint32
envVars?|null
ports?|null
preset?null|string
systemd?null|
users?|null
groups?|null
additionalFiles?|null
webTerminal?boolean|null
webVscode?boolean|null
additionalRepositories?|null
repoId?string|null
computeClass?string|null
Default"high"
domain?string|nullDeprecated
repo?string|nullDeprecated
gitRef?string|null
preDevCommandOnce?string|null
baseId?string|nullDeprecated

Response Body

application/json

curl -X POST "https://api.freestyle.sh/ephemeral/v1/dev-servers" \  -H "Content-Type: application/json" \  -d '{}'
{
  "url": "string",
  "isNew": true,
  "devCommandRunning": true,
  "installCommandRunning": true,
  "mcpEphemeralUrl": "string",
  "ephemeralUrl": "string",
  "vmId": "string",
  "baseId": "string"
}

Freestyle AI

Documentation assistant

Experimental: AI responses may not always be accurate—please verify important details with the official documentation.

How can I help?

Ask me about Freestyle while you browse the docs.