---
title: "Create new Execution Runner Host"
method: POST
path: "/execution/hosts"
tags: ["ExecutionHost"]
---

# Create new Execution Runner Host

`POST /execution/hosts`

Create Execution Host for tracking a single host of one or more runner instances

## Request body

- CreateExecutionHostRequest — Host for execution runners
  - `execution_cluster_id` string — cluster this host belongs to
  - `provider` 'google_cloud' | 'amazon_web_services' | 'customer', required — Cloud where execution host resides
  - `region` string — region the execution host is in
  - `zone` string — zone the execution host is in
  - `ipv4_address` string — Currently associated IP address (typically RFC 1918)
  - `provider_instance_id` string — id of the host within the provider
  - `labels` string[] — Host labels
  - `capabilities` string[] — Host supported capabilities
  - `current_state` ExecutionNodeState — Execution node state
    - `versions` object — Map of software versions running on the cluster
    - `lastUpdatedTime` integer
  - `status` 'initializing' | 'ready' | 'updating' | 'shutting_down' | 'stopped', required — Status of execution host
  - `memory_mib` integer — memory in megabytes available on the host
  - `cpu` integer — cpus available on the host
  - `instance_type` string — Unique identifies for the instance type (e.g. mac1.metal)
  - `os` 'windows' | 'linux' | 'osx' — Operation system used in the runtime
  - `workspace_id` string, required — Id of workspace this host is assigned to or 'mabl' for general purpose

## Response `201`

Execution Host

- ExecutionHost — Patch select Execution Host properties
  - `execution_cluster_id` string — cluster this host belongs to
  - `provider` 'google_cloud' | 'amazon_web_services' | 'customer', required — Cloud where execution host resides
  - `region` string — region the execution host is in
  - `zone` string — zone the execution host is in
  - `ipv4_address` string — Currently associated IP address (typically RFC 1918)
  - `provider_instance_id` string — id of the host within the provider
  - `labels` string[] — Host labels
  - `capabilities` string[] — Host supported capabilities
  - `current_state` ExecutionNodeState — Execution node state
    - `versions` object — Map of software versions running on the cluster
    - `lastUpdatedTime` integer
  - `status` 'initializing' | 'ready' | 'updating' | 'shutting_down' | 'stopped', required — Status of execution host
  - `memory_mib` integer — memory in megabytes available on the host
  - `cpu` integer — cpus available on the host
  - `instance_type` string — Unique identifies for the instance type (e.g. mac1.metal)
  - `os` 'windows' | 'linux' | 'osx' — Operation system used in the runtime
  - `workspace_id` string, required — Id of workspace this host is assigned to or 'mabl' for general purpose
  - `command` ExecutionHostCommand — Command to send to execution host
    - `command_type` 'update' | 'shutdown' | 'restart_runners' | 'none' — The command to deliver to the execution host
    - `target_state` ExecutionNodeState — Execution node state
      - `versions` object — Map of software versions running on the cluster
      - `lastUpdatedTime` integer
    - `context` object — map of additional context properties to include with the command
  - `id` string, required — API generated globally unique ID
  - `etag` string — API version etag
  - `created_time` integer, required — Creation time, epoch millis
  - `created_by_id` string, required — Creation principal ID
  - `last_updated_time` integer, required — Last updated time, epoch millis
  - `last_updated_by_id` string, required — Last updating principal ID
  - `deleted_time` integer — Deletion time, epoch millis
  - `deleted_by_id` string — Deletion principal ID

## Other responses

- `401` — Missing or invalid credentials
- `403` — Actor is not authorized to make this call
- `409` — Execution Host with ID already exists
- `default` — Unknown error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)