Start a sandbox by name

curl --request POST \
  --url https://api.microsandbox.dev/v1/sandboxes/by-name/{name}/start \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.microsandbox.dev/v1/sandboxes/by-name/{name}/start"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.microsandbox.dev/v1/sandboxes/by-name/{name}/start', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.microsandbox.dev/v1/sandboxes/by-name/{name}/start",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.microsandbox.dev/v1/sandboxes/by-name/{name}/start"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.microsandbox.dev/v1/sandboxes/by-name/{name}/start")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.microsandbox.dev/v1/sandboxes/by-name/{name}/start")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "created_at": "2023-11-07T05:31:56Z",
  "ephemeral": true,
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "slug": "<string>",
  "status": "created",
  "automatic_recovery_ends_at": "2023-11-07T05:31:56Z",
  "last_failure_message": "<string>",
  "spec": {
    "env": [
      {
        "key": "<string>",
        "value": "<string>"
      }
    ],
    "labels": {},
    "lifecycle": {
      "ephemeral": true,
      "idle_timeout_secs": 1,
      "max_duration_secs": 1
    },
    "mounts": [
      {
        "guest": "<string>",
        "host_permissions": "private",
        "options": {
          "nodev": false,
          "noexec": false,
          "nosuid": false,
          "override_gid": null,
          "override_uid": null,
          "readonly": false
        },
        "stat_virtualization": "strict",
        "type": "Bind",
        "quota_mib": 1
      }
    ],
    "network": {
      "enabled": true,
      "ports": [
        {
          "guest_port": 1,
          "host_bind": "<string>",
          "host_port": 1,
          "protocol": "tcp"
        }
      ],
      "trust_host_cas": true,
      "dns": {
        "nameservers": [],
        "query_timeout_ms": 5000,
        "rebind_protection": true
      },
      "interface": {
        "ipv4_address": null,
        "ipv4_pool": null,
        "ipv6_address": null,
        "ipv6_pool": null,
        "mac": null,
        "mtu": null
      },
      "max_connections": 1,
      "policy": {
        "default_egress": "allow",
        "default_ingress": "allow",
        "rules": [
          {
            "action": "allow",
            "destination": "any",
            "direction": "egress",
            "ports": [
              {
                "end": 1,
                "start": 1
              }
            ],
            "protocols": [
              "tcp"
            ]
          }
        ]
      },
      "secrets": [
        {
          "allowed_hosts": [
            {}
          ],
          "env_var": "<string>",
          "injection": {},
          "placeholder": "<string>",
          "on_violation": {}
        }
      ],
      "tls": {
        "block_quic_on_intercept": true,
        "bypass": [
          "<string>"
        ],
        "cache": {
          "capacity": 1,
          "validity_hours": 1
        },
        "enabled": true,
        "intercept_ca": {
          "cert_path": "<string>",
          "key_path": "<string>"
        },
        "intercepted_ports": [
          1
        ],
        "scoped_upstream_ca_cert": [
          {
            "path": "<string>",
            "pattern": "<string>"
          }
        ],
        "scoped_verify_upstream": [
          {
            "pattern": "<string>",
            "verify": true
          }
        ],
        "upstream_ca_cert": [
          "<string>"
        ],
        "verify_upstream": true
      }
    },
    "resources": {
      "disk_size_mib": null,
      "memory_mib": 512,
      "vcpus": 1
    },
    "rlimits": [
      {
        "hard": 1,
        "resource": "Cpu",
        "soft": 1
      }
    ],
    "runtime": {
      "cmd": null,
      "disable_metrics_sample": false,
      "entrypoint": null,
      "hostname": null,
      "log_level": "error",
      "metrics_sample_interval_ms": 1000,
      "scripts": {},
      "shell": null,
      "user": null,
      "workdir": null
    },
    "image": "<string>"
  },
  "started_at": "2023-11-07T05:31:56Z",
  "status_reason": "scheduling",
  "stopped_at": "2023-11-07T05:31:56Z",
  "temporarily_unavailable_since": "2023-11-07T05:31:56Z"
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "unauthorized",
    "details": null
  }
}

{
  "error": {
    "code": "sandbox_not_found",
    "message": "resource not found",
    "details": null
  }
}

{
  "error": {
    "code": "invalid_state_transition",
    "message": "invalid state transition",
    "details": null
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "too many requests",
    "details": null
  }
}

{
  "error": {
    "code": "orchestrator_unreachable",
    "message": "orchestrator unreachable",
    "details": null
  }
}