Create Machine

POST

https://api.islo.dev/factories/:factory/machines

POST

/factories/:factory/machines

curl -X POST https://api.islo.dev/factories/factory/machines \
     -H "X-Islo-Api-Version: X-Islo-Api-Version" \
     -H "Authorization: Bearer <api_key>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "string"
}'

{
  "capabilities": [
    "docker"
  ],
  "created_at": "2024-01-15T09:30:00Z",
  "disk_gb": 1,
  "environment": "string",
  "gateway_profile": "string",
  "lifecycle": {
    "auto_resume": "never",
    "delete_after": 1,
    "pause_after": 1,
    "pause_after_idle": 1
  },
  "memory_mb": 1,
  "name": "string",
  "repos": [
    {
      "repo_url": "string",
      "branch": "string",
      "key": "string",
      "primary": false,
      "target_path": "string"
    }
  ],
  "schedule": {
    "cron": "string",
    "enabled": false,
    "timezone": "UTC"
  },
  "status": "defined",
  "updated_at": "2024-01-15T09:30:00Z",
  "vcpus": 1,
  "last_build": {
    "finished_at": "2024-01-15T09:30:00Z",
    "reason": "create",
    "run_id": "string",
    "started_at": "2024-01-15T09:30:00Z",
    "status": "running",
    "actor": {
      "type": "user",
      "display_name": "string",
      "id": "string"
    },
    "failure_summary": "string",
    "level": "verify",
    "live": false,
    "report": {
      "components": [
        {
          "name": "string",
          "state": "passed",
          "commands": [
            "string"
          ],
          "output": "",
          "remediation": ""
        }
      ],
      "findings": "",
      "omitted_blocked": 0,
      "omitted_components": 0,
      "omitted_failed": 0,
      "required_capabilities": [
        "string"
      ]
    },
    "version_number": 1
  },
  "level": "verify",
  "version_number": 1
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

factorystringRequired

Request

This endpoint expects an object.

namestringRequiredformat: "^[a-z][a-z0-9-]{0,40}$"

capabilitieslist of enumsOptional

Allowed values:

disk_gbintegerOptional>=1Defaults to 10

environmentstring or nullOptional

gateway_profilestring or nullOptional

levelenumOptionalDefaults to source

Allowed values:

lifecycleobject or nullOptional

memory_mbintegerOptional>=1Defaults to 2048

reposlist of objectsOptional

scheduleobjectOptional

vcpusintegerOptional>=1Defaults to 2

Response

Successful Response

capabilitieslist of enums

Allowed values:

created_atdatetime

disk_gbinteger>=1

environmentstring or null

gateway_profilestring or null

lifecycleobject or null

memory_mbinteger>=1

namestring

reposlist of objects

scheduleobject

statusenum

Allowed values:

updated_atdatetime

vcpusinteger>=1

last_buildobject or nullOptional

levelenumOptionalDefaults to verify

Allowed values:

version_numberinteger or nullOptional

Errors

422

Unprocessable Entity Error

Authentication

Path parameters

Headers

Request

Response

Errors