---
title: "Validate a form draft"
method: POST
path: "/forms/{form_id}/validate"
---

# Validate a form draft

`POST /forms/{form_id}/validate`

## Request

- Base URL: `https://app.formasty.com/api/v1`
- URL: `https://app.formasty.com/api/v1/forms/{form_id}/validate`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://app.formasty.com/oauth/authorize/api/v1`, token URL `https://app.formasty.com/oauth/token`)
  - HTTP bearer

Runs the same schema, workflow, settings, booking, and plan-gate preflight used by Formasty agents without changing or publishing the form.

## Path parameters

- `form_id` string, required

## Response `200`

Current draft revision and publish-readiness report.

- DraftValidationResponse
  - `data` object, required
    - `form_id` string, required
    - `draft_revision` integer, required
    - `draft_updated_at` integer, required
  - `validation` DraftValidationSummary, required
    - `publishReady` boolean, required
    - `summary` string, required
    - `validatedDraftRevision` integer, required
    - `validatedDraftUpdatedAt` integer, required
    - `inactiveDueToPlan` boolean, required
    - `plan` 'free' | 'pro', required
    - `lockedFeatureKeys` string[]
    - `inactiveFeatureKeys` string[]
    - `issues` DraftValidationIssue[], required
      - `kind` 'schema' | 'workflow' | 'settings' | 'plan' | 'booking', required
      - `severity` 'error' | 'warning'
      - `code` string
      - `path` string
      - `message` string, required
      - `repairActions` string[]

## Other responses

- `401`: Missing or invalid OAuth token or API key.
- `403`: Missing forms:read scope or workspace permission.
- `404`: Form not found in the authenticated credential's workspace.
- `default`: A machine-readable error with a stable code and a recovery hint. The legacy error value is retained for existing clients.

---

[API](https://skmtc.dev/formasty/apis/formasty-forms-api.md) · [All operations](https://skmtc.dev/formasty/apis/formasty-forms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/formasty/apis/formasty-forms-api/revisions/09ad7f50c693?raw)