Cloud endpoint

Create Machine Configuration

Send this request to the AkôFlow daemon. Authentication is required when an API token is configured.

POST/machine-configurations/

Body

application/json

id string

Field defined by domain.MachineConfiguration.

name string

Field defined by domain.MachineConfiguration.

description string

Field defined by domain.MachineConfiguration.

ownership string

Field defined by domain.MachineConfiguration.

enabled boolean

Field defined by domain.MachineConfiguration.

versions array

Field defined by domain.MachineConfiguration.

createdAt string

Field defined by domain.MachineConfiguration.

updatedAt string

Field defined by domain.MachineConfiguration.

cURL

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/"

201 Createdapplication/json

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

domain.MachineConfiguration

Related guide

See the Cloud guide for the corresponding Desktop workflow, concepts, and authored request examples.

Generated from the daemon router

This page is generated from internal/api/httpserver/httpserver.go, the registered handler, and JSON-tagged Go structs. Method, path, request fields, response kind, query parameters, media type, and successful status codes stay synchronized with the implementation.