---
title: "Read app install convergence state"
method: GET
path: "/apply/v1/app-installs"
tags: ["Apply"]
---

# Read app install convergence state

`GET /apply/v1/app-installs`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/apply/v1/app-installs`
- Auth: API key in header `SIGN-IN-WITH-X`

Reads per-project/per-app convergence state for run402 up diagnostics and resume.

## Query parameters

- `project_id` string, required
- `app_key` string, required

## Response `200`

App install state

- AppInstallState
  - `id` string, required
  - `project_id` string, required
  - `app_key` string, required
  - `status` 'requested' | 'planning' | 'applying' | 'active' | 'failed', required
  - `manifest_digest` unknown
  - `graph_digest` unknown
  - `source` object, required
  - `manifest` object, required
  - `resources` object, required
  - `bindings` object, required
  - `last_operation_id` unknown
  - `error` unknown
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `404`: No state has been recorded for this project/app key.

---

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