Cloud endpoint

Validate Machine Configuration

POST/machine-configuration-validations/

Example request

application/json

{
  "playbookYaml": "- hosts: all\n  tasks:\n    - ansible.builtin.debug:\n        msg: ready\n"
}

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

Supply a valid request.json before running this command.

200 OKapplication/json

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

{
  "valid": true,
  "sha256": "string",
  "errors": [
    "string"
  ]
}

Handler-checked behavior

Send playbookYaml containing the Ansible playbook text. Valid input returns 200 OK with valid: true and a content hash; invalid input returns 422 with valid: false and errors. This validates structure only and does not run a playbook or provision a machine.

Related guide

See the Cloud guide for related tasks and context.