---
title: "Get Uninstallation State"
method: GET
path: "/installation/uninstallation"
tags: ["Management"]
---

# Get Uninstallation State

`GET /installation/uninstallation`

Returns the current uninstallation workflow state if an uninstallation has been started.

## Headers

- `x-gw-ims-org-id` string, required

## Response `200`

The current uninstallation workflow state.

- union
  - object
    - `id` string, required
    - `status` 'in-progress', required
    - `startedAt` string, date-time, required
    - `step` StepStatus, required
      - `name` string, required
      - `id` string, required
      - `path` string[], required
      - `meta` StepMetaInfo, required
        - `label` string, required
        - `description` string
      - `status` 'pending' | 'in-progress' | 'succeeded' | 'failed', required
      - `children` StepStatus[], required
    - `config` object — The validated app configuration recorded at install time. Present so uninstallation can be sourced from what was actually installed rather than the current request config. Absent on states persisted before this field was introduced.
    - `data` object, nullable, required
  - object
    - `id` string, required
    - `status` 'succeeded', required
    - `startedAt` string, date-time, required
    - `completedAt` string, date-time, required
    - `step` StepStatus, required
      - `name` string, required
      - `id` string, required
      - `path` string[], required
      - `meta` StepMetaInfo, required
        - `label` string, required
        - `description` string
      - `status` 'pending' | 'in-progress' | 'succeeded' | 'failed', required
      - `children` StepStatus[], required
    - `config` object — The validated app configuration recorded at install time. Present so uninstallation can be sourced from what was actually installed rather than the current request config. Absent on states persisted before this field was introduced.
    - `data` object, nullable, required
    - `metadata` object
      - `isRetry` boolean, required
  - object
    - `id` string, required
    - `status` 'failed', required
    - `startedAt` string, date-time, required
    - `completedAt` string, date-time, required
    - `step` StepStatus, required
      - `name` string, required
      - `id` string, required
      - `path` string[], required
      - `meta` StepMetaInfo, required
        - `label` string, required
        - `description` string
      - `status` 'pending' | 'in-progress' | 'succeeded' | 'failed', required
      - `children` StepStatus[], required
    - `config` object — The validated app configuration recorded at install time. Present so uninstallation can be sourced from what was actually installed rather than the current request config. Absent on states persisted before this field was introduced.
    - `data` object, nullable, required
    - `error` object, required
      - `path` string[], required
      - `key` string, required
      - `message` string
      - `payload` unknown
    - `metadata` object
      - `isRetry` boolean, required

## Other responses

- `204` — No uninstallation workflow state has been stored yet.
- `401` — You are not authorized to access this resource. Ensure the IMS token and the x-gw-ims-org-id header are correctly set and valid.
- `403` — The access token is valid, but it is not allowed to access the requested organization or operation.
- `500` — An unexpected server error occurred.

---

[API](https://skmtc.dev/adobe/apis/app-management-api.md) · [All operations](https://skmtc.dev/adobe/apis/app-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adobe/app-management-api/revisions/4b39b5956be9/schema)