Cloud endpoint

Create Machine Configuration Version

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

POST/machine-configurations/{configurationId}/versions/

Path parameters

configurationId

Identifier used by the registered route.

Body

application/json

id string

Field defined by domain.MachineConfigurationVersion.

machineConfigurationId string

Field defined by domain.MachineConfigurationVersion.

version number

Field defined by domain.MachineConfigurationVersion.

status string

Field defined by domain.MachineConfigurationVersion.

playbookYaml string

Field defined by domain.MachineConfigurationVersion.

contentSha256 string

Field defined by domain.MachineConfigurationVersion.

compatibility object

Field defined by domain.MachineConfigurationVersion.

variablesSchema object

Field defined by domain.MachineConfigurationVersion.

validationChecks array

Field defined by domain.MachineConfigurationVersion.

createdAt string

Field defined by domain.MachineConfigurationVersion.

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/{configurationId}/versions/"

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.