---
title: "Validate Installation"
method: POST
path: "/installation/validation"
tags: ["Management"]
---

# Validate Installation

`POST /installation/validation`

Validates the installation inputs and workflow steps without starting installation.

## 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 `200`

The validation result, including issue counts and per-step validation results.

- object
  - `valid` boolean, required
  - `summary` object, required
    - `totalIssues` number, required
    - `errors` number, required
    - `warnings` number, required
  - `result` StepValidationResult, required
    - `name` string, required
    - `path` string[], required
    - `meta` StepMetaInfo, required
      - `label` string, required
      - `description` string
    - `issues` ValidationIssue[], required
      - `code` string, required
      - `message` string, required
      - `severity` 'error' | 'warning' | 'info', required
      - `details` object
    - `children` StepValidationResult[], 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.
- `500` — An unexpected server error occurred.

## Changes

- **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/validation/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)