---
title: "GET /v2/infra-envs/{infra_env_id}/hosts/{host_id}/instructions"
method: GET
path: "/v2/infra-envs/{infra_env_id}/hosts/{host_id}/instructions"
tags: ["installer"]
---

# GET /v2/infra-envs/{infra_env_id}/hosts/{host_id}/instructions

`GET /v2/infra-envs/{infra_env_id}/hosts/{host_id}/instructions`

## Request

- Base URL: `http://api.openshift.com/api/assisted-install`
- URL: `http://api.openshift.com/api/assisted-install/v2/infra-envs/{infra_env_id}/hosts/{host_id}/instructions`
- Auth: API key in header `X-Secret-Key`

Retrieves the next operations that the host agent needs to perform.

## Path parameters

- `infra_env_id` string, uuid, required
- `host_id` string, uuid, required

## Query parameters

- `timestamp` integer

## Headers

- `discovery_agent_version` string

## Response `200`

Success.

- Steps
  - `next_instruction_seconds` integer
  - `post_step_action` 'exit' | 'continue': What to do after finishing to run step instructions
  - `instructions` Step[]
    - `step_type` 'connectivity-check' | 'execute' | 'inventory' | 'install' | 'free-network-addresses' | 'dhcp-lease-allocate' | 'api-vip-connectivity-check' | 'tang-connectivity-check' | 'ntp-synchronizer' | 'installation-disk-speed-check' | 'container-image-availability' | 'domain-resolution' | 'stop-installation' | 'logs-gather' | 'next-step-runner' | 'upgrade-agent' | 'download-boot-artifacts' | 'reboot-for-reclaim' | 'verify-vips'
    - `step_id` string
    - `args` string[]

## Other responses

- `401`: Unauthorized.
- `403`: Forbidden.
- `404`: Error.
- `405`: Method Not Allowed.
- `500`: Error.
- `501`: Not implemented.
- `503`: Unavailable.

---

[API](https://skmtc.dev/openshift/apis/assistedinstall.md) - [All operations](https://skmtc.dev/openshift/apis/assistedinstall/llms.txt) - [OpenAPI document](https://skmtc.dev/openshift/apis/assistedinstall/revisions/e3a182505ca3?raw)