---
title: "Get a setup run's status"
method: GET
path: "/api/projects/{project_id}/wizard/installs/{run_id}/"
tags: ["wizard"]
---

# Get a setup run's status

`GET /api/projects/{project_id}/wizard/installs/{run_id}/`

## Request

- Base URL: `https://us.posthog.com`
- URL: `https://us.posthog.com/api/projects/{project_id}/wizard/installs/{run_id}/`
- Auth: HTTP bearer

Get the status of a cloud setup run, its task list, the pull request link once it exists, and a next step to relay to the user.

## Path parameters

- `project_id` string, required
- `run_id` string, required

## Response `200`

- WizardInstallStatus
  - `status` 'created' | 'running' | 'completed' | 'failed' | 'cancelled', required: * `created` - created * `running` - running * `completed` - completed * `failed` - failed * `cancelled` - cancelled
  - `stage` union, required: Step the setup run is on while it is in progress, or null otherwise. * `dispatching` - dispatching * `provisioning` - provisioning * `preparing_workspace` - preparing_workspace * `executing_wizard` - executing_wizard * `creating_artifacts` - creating_artifacts
    - 'dispatching' | 'provisioning' | 'preparing_workspace' | 'executing_wizard' | 'creating_artifacts': * `dispatching` - dispatching * `provisioning` - provisioning * `preparing_workspace` - preparing_workspace * `executing_wizard` - executing_wizard * `creating_artifacts` - creating_artifacts
    - unknown
  - `error_code` string, nullable, required: Machine-readable failure reason, or null if the run has not failed.
  - `error_message` string, nullable, required: Failure explanation, or null if the run has not failed.
  - `pull_request_url` string, uri, nullable, required: Pull request with the setup changes, or null until the run opens one.
  - `tasks` WizardInstallTask[], required: Tasks the setup agent planned, in order.
    - `name` string, required: Task the setup agent planned.
    - `status` 'created' | 'running' | 'completed' | 'failed', required: * `created` - created * `running` - running * `completed` - completed * `failed` - failed
  - `next_step` string, required: What happens next, in a sentence to relay to the user.

## Other responses

- `404`

## Changes

> 53 revisions in range; 1 not diffed.

- **2026-10-21** `04a392d92a14`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/posthog/apis/posthog-api/changes/api/projects/:project_id/wizard/installs/:run_id/get.md)

---

[API](https://skmtc.dev/posthog/apis/posthog-api.md) · [All operations](https://skmtc.dev/posthog/apis/posthog-api/llms.txt) · [OpenAPI document](https://skmtc.dev/posthog/apis/posthog-api/revisions/993f70ab941b?raw)