---
title: "Query Execution Hosts"
method: GET
path: "/execution/hosts/workspace/{workspace_id}"
tags: ["ExecutionHost"]
---

# Query Execution Hosts

`GET /execution/hosts/workspace/{workspace_id}`

Query Execution Hosts, sorted last updated time descending

## Path parameters

- `workspace_id` string, required

## Query parameters

- `operating_system` 'windows' | 'linux' | 'osx' — Operation system used in the runtime
- `status` 'initializing' | 'ready' | 'updating' | 'shutting_down' | 'stopped', required — Status of execution host
- `sort` 'created_time' | 'last_updated_time'
- `limit` integer
- `cursor` string

## Response `200`

Execution Host

- ExecutionHostQueryResult — Common paginated response result holder
  - `count` integer, required — Number of items returned in this response, maybe 0 if count == limit on last call
  - `limit` integer — Limit applied to this query
  - `cursor` string — Cursor that can be used to fetch the next page, count <= limit
  - `items` ExecutionHost[] — Results
    - `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
- `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)