---
title: "Start Uninstallation"
method: POST
path: "/installation/uninstallation"
tags: ["Management"]
---

# Start Uninstallation

`POST /installation/uninstallation`

Starts the uninstallation workflow and stores the initial execution state.

## Headers

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

## Request body

- object
  - `appData` AppData, required
    - `consumerOrgId` string, required
    - `orgName` string, required
    - `projectId` string, required
    - `projectName` string, required
    - `projectTitle` string, required
    - `workspaceId` string, required
    - `workspaceName` string, required
    - `workspaceTitle` string, required
  - `commerceBaseUrl` string, required
  - `commerceEnv` 'paas' | 'saas', required
  - `ioEventsUrl` string, required
  - `ioEventsEnv` string, required

## Response `202`

The uninstallation workflow was accepted and queued for asynchronous execution.

- object
  - `message` string, required
  - `activationId` string, required
  - `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

## Other responses

- `400` — The request is invalid or could not be parsed.
- `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.
- `409` — The uninstallation workflow is already running.
- `500` — An unexpected server error occurred.

## Changes

- **2026-07-06** `7f3e5f61a43a` — 1 info
  - added the optional property `config` to the response with the `202` status
- **2026-07-01** `d85db665cc4c` — 1 warning
  - removed the request property `appData/adminUiViewUrl`
- **2026-06-26** `1375dc66746f` — 1 info
  - added the new optional request property `appData/adminUiViewUrl`
- **2026-06-12** `59e3a5482a5b` — 1 breaking, 2 info
  - request property `commerceEnv` was restricted to a list of enum values
  - added the new `paas` enum value to the request property `commerceEnv`
  - added the new `saas` enum value to the request property `commerceEnv`

[Change history](https://skmtc.dev/adobe/apis/app-management-api/changes/installation/uninstallation/post.md)

---

[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)