Cloud endpoint

Start Cloud Provisioning

POST/environments/{environmentId}/cloud-provisioning/

Path parameters

environmentId

Identifier used by the registered route.

Request body

application/json

See the request guidance below for a valid body.

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}/environments/{environmentId}/cloud-provisioning/"

Supply a valid request.json before running this command.

Replace the path identifiers with IDs from your instance.

202 Acceptedapplication/json

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

{
  "id": "string",
  "kind": "string",
  "status": "string",
  "environmentId": "string",
  "capacityTargetId": "string",
  "instanceId": "string",
  "executionRunId": "string",
  "activityId": "string",
  "phase": "string",
  "request": {
    "capacityTargetId": "string",
    "name": "string",
    "sshUsername": "string",
    "instanceId": "string"
  },
  "failureReason": "string",
  "createdAt": "2026-01-01T00:00:00Z",
  "startedAt": "2026-01-01T00:00:00Z",
  "finishedAt": "2026-01-01T00:00:00Z"
}

Handler-checked behavior

This compatibility route accepts the same capacityTargetId request as Provision Cloud Instance. It queues the same operation and returns 202 Accepted; target, environment, credential, and provider failures can appear later in its status and events. Wait for completion before treating the VM as ready.

Related guide

See the Cloud guide for related tasks and context.