---
title: "POST /workflows/{workflowId}/validate"
method: POST
path: "/workflows/{workflowId}/validate"
tags: ["Workflows"]
---

# POST /workflows/{workflowId}/validate

`POST /workflows/{workflowId}/validate`

Validate a workflow.

## Path parameters

- `workflowId` string, uuid, required

## Query parameters

- `api-version` string, required

## Request body

- WorkflowCreateOrUpdateCommand — Create or update workflow payload.
  - `triggers` Trigger[], required — It describes under what condition a workflow will run.
    - `type` 'when_term_creation_is_requested' | 'when_term_deletion_is_requested' | 'when_term_update_is_requested' | 'when_terms_import_is_requested' | 'when_data_access_grant_is_requested' | 'when_asset_update_is_requested', required
    - `underGlossaryHierarchy` string — Glossary term hierarchy path.
    - `underCollection` string — The collection name.
    - `underGlossary` string — The glossary guid.
  - `name` string, required — The workflow name.
  - `isEnabled` boolean, required — Whether the workflow enabled or not.
  - `description` string, required — Description of a workflow.
  - `actionDag` object — The action DAG(Directed Acyclic Graph), it defines actual flow.

## Response `200`

OK

- WorkflowValidationRuleViolationsList
  - `value` WorkflowValidationRuleViolation[], required — The value of violated validation rule list.
    - `severity` 'error' | 'warning', required — The severity of the validation rule.
    - `location` object, required — The location where the violation happens.
      - `type` 'workflow' | 'action' | 'actionParameter', required — The validation violation location type.
      - `actionName` string — The name of the action where the violation happens.
      - `parameterKey` string — The key of the action parameter where the violation happens.
    - `message` string, required — The detail about how the validation rule is violated.

## Other responses

- `default` — Error response describing why the operation failed.

## Changes

- **2026-07-13** (2022-05-01-preview) `60435bfd503d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/purview-workflow/changes/workflows/:workflowId/validate/post.md)

---

[API](https://skmtc.dev/azure/apis/purview-workflow.md) · [All operations](https://skmtc.dev/azure/apis/purview-workflow/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/purview-workflow/revisions/60435bfd503d/schema)