---
title: "POST /v1/workflows/validate"
method: POST
path: "/v1/workflows/validate"
---

# POST /v1/workflows/validate

`POST /v1/workflows/validate`

Validate a workflow definition without saving

## Request body

- union
  - object
  - ValidateWorkflowParams
    - `definition` GithubComB3FunB3MonoServicesB3osWorkflowInternalPkgEntityWorkflowDefinition, required — Definition is the full workflow graph to execute. Must contain a "root" node with type "manual". All action nodes referenced in children arrays must be present.
      - `inputSchema` GithubComB3FunB3MonoServicesB3osWorkflowInternalPkgEntityWorkflowInput[]
        - `description` string
        - `key` string
        - `required` boolean
        - `type` string — "string", "number", "boolean", "object", "array"
      - `nodes` object, required
      - `sensitivePropKeys` string[]
    - `name` string

## Response `200`

OK

- ValidateWorkflowSuccessResponse
  - `code` integer
  - `data` ValidationResult
    - `errors` ValidationErrorItem[]
      - `field` string — Optional field name
      - `message` string — Human readable error message
      - `nodeId` string — Optional node ID
      - `nodeName` string — Optional node display name
      - `type` string — name, nodes, root, connectivity, pattern, variable
    - `valid` boolean
  - `message` string
  - `requestId` string

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/b3-fun/apis/b3os-workflow-api.md) · [All operations](https://skmtc.net/b3-fun/apis/b3os-workflow-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/b3-fun/b3os-workflow-api/versions/5a750a5a9596/schema)