Executions endpoint

Create Execution

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

POST/execution-runs/

Body

application/json

Run object

Field defined by ports.ExecutionRequest.

Plan object

Field defined by ports.ExecutionRequest.

Workflow object

Field defined by ports.ExecutionRequest.

Resources array

Field defined by ports.ExecutionRequest.

ExecutionScope object

Field defined by ports.ExecutionRequest.

Runtimes array

Field defined by ports.ExecutionRequest.

RuntimeBindings array

Field defined by ports.ExecutionRequest.

NetworkTopology object

Field defined by ports.ExecutionRequest.

ActivityProfiles array

Field defined by ports.ExecutionRequest.

PreparationRequirementsByActivity object

Field defined by ports.ExecutionRequest.

RuntimeAllocations object

Field defined by ports.ExecutionRequest.

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}/execution-runs/"

202 Acceptedapplication/json

{
  "id": "string",
  "category": "string",
  "eventType": "string",
  "aggregateType": "string",
  "aggregateId": "string",
  "status": "string",
  "priority": 0,
  "availableAt": "2026-01-01T00:00:00Z",
  "leaseOwner": "string",
  "leaseExpiresAt": "2026-01-01T00:00:00Z",
  "attempts": 0,
  "maxAttempts": 0,
  "idempotencyKey": "string",
  "lastError": "string",
  "createdAt": "2026-01-01T00:00:00Z",
  "startedAt": "2026-01-01T00:00:00Z",
  "completedAt": "2026-01-01T00:00:00Z"
}

domainqueue.Job

Related guide

See the Executions 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.