Cloud endpoint

Create Machine Configuration

POST/machine-configurations/

Example request

application/json

{
  "id": "example-machine-setup",
  "name": "Example machine setup"
}

cURL template

curl --fail-with-body \
  -H "Authorization: Bearer ${AKOFLOW_API_TOKEN}" \
  -H "Content-Type: application/json" \
  --data-binary @request.json \
  -X POST \
  "${AKOFLOW_API_URL}/machine-configurations/"

Supply a valid request.json before running this command.

201 Createdapplication/json

Field shape inferred from Go types; inspect the returned JSON for actual values and optional fields.

{
  "id": "string",
  "name": "string",
  "description": "string",
  "ownership": "string",
  "enabled": true,
  "versions": [
    {
      "id": "string",
      "machineConfigurationId": "string",
      "version": 0,
      "status": "string",
      "playbookYaml": "string",
      "contentSha256": "string",
      "compatibility": {},
      "variablesSchema": {},
      "validationChecks": [],
      "createdAt": "2026-01-01T00:00:00Z"
    }
  ],
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z"
}

Handler-checked behavior

name is required. id is optional and generated when omitted. The server sets ownership: user and enabled: true. Create a version separately; this request does not validate or execute a playbook.

Related guide

See the Cloud guide for related tasks and context.