LogoFreestyle
API Reference/Dev servers

Execute a command on a Dev Server

POST
/ephemeral/v1/dev-servers/exec

Request Body

application/jsonRequired
devServerRequiredobject
commandRequiredstring
backgroundRequiredboolean

Spawn this command as a background process and return immediately

Response Body

200

Successful

idRequiredstring
isNewRequiredboolean
stdoutarray | null
stderrarray | null

500

Internal Server Error

responseRequiredstring
curl -X POST "https://api.freestyle.sh/ephemeral/v1/dev-servers/exec" \
  -H "Content-Type: application/json" \
  -d '{
    "devServer": {
      "repoId": "c7c90052-c566-40b6-94a5-a1e9a44bfdc7",
      "gitRef": "string",
      "kind": "repo"
    },
    "command": "string",
    "background": true
  }'

Successful

{
  "id": "string",
  "isNew": true,
  "stdout": [
    "string"
  ],
  "stderr": [
    "string"
  ]
}

Request a Dev Server POST

Previous Page

Commit and push changes to a Dev Server repository POST

Next Page

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.