---
title: "Validate an Automation Agent for Premiere Pro DSL document"
method: POST
path: "/v1/validate/dsl"
---

# Validate an Automation Agent for Premiere Pro DSL document

`POST /v1/validate/dsl`

## Request

- Base URL: `https://api.mamoworld.com`
- URL: `https://api.mamoworld.com/v1/validate/dsl`
- Auth: none declared
- TypeScript: <https://skmtc.dev/mamoworld/apis/automation-agent-for-premiere-pro-validation-api/docs/v1/validate/dsl/post.ts> (a function with typed inputs; its response is checked against the schema)

Validates a DSL JSON object. Send the full DSL JSON inside `dslDocument`. If hostApp is omitted, premierepro is assumed.

## Request body

- object
  - `hostApp` string: Target host application. Current default and primary target is premierepro.
  - `debug` boolean: Optional troubleshooting flag. Normal requests use fail-fast schema validation; when true, validation collects up to 20 schema errors and the response includes validator debug details.
  - `dslDocument` object, required: The complete Automation Agent for Premiere Pro DSL JSON document to validate.

## Response `200`

Validation succeeded.

- ValidateDslResponse
  - `service` string, required
  - `status` 'ok', required
  - `timestampUtc` string, required
  - `message` string, required
  - `request` RequestSummary, required
    - `method` string, required
    - `uri` string, required
    - `path` string, required
    - `host` string, required
  - `validation` ValidateDslResult, required
    - `kind` 'dsl', required
    - `hostApp` string, required
    - `ok` boolean, required
    - `validatorEngine` string, required: Validation backend used by the server. Expected production value: opis-json-schema+semantic-checks.
    - `diagnostics` object, required
      - `schemaErrorCount` integer, required
      - `guardErrorCount` integer, required
      - `warningCount` integer, required
    - `summary` string, required
    - `suggestions` string[], required
    - `debug` object, nullable, required
    - `errorCount` integer, required
    - `errors` ValidationErrorEntry[], required
      - `path` string, required
      - `message` string, required
      - `keyword` string, required
      - `source` string, required: Origin of the issue. schema means JSON-Schema validation; semantic-check means additional server-side consistency checks.
      - `suggestion` string, nullable, required
      - `candidates` string[]
    - `warningCount` integer, required
    - `warnings` ValidationErrorEntry[], required
      - `path` string, required
      - `message` string, required
      - `keyword` string, required
      - `source` string, required: Origin of the issue. schema means JSON-Schema validation; semantic-check means additional server-side consistency checks.
      - `suggestion` string, nullable, required
      - `candidates` string[]

## Other responses

- `400`: Malformed request.
- `422`: Validation failed.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/mamoworld/apis/automation-agent-for-premiere-pro-validation-api.md) - [All operations](https://skmtc.dev/mamoworld/apis/automation-agent-for-premiere-pro-validation-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mamoworld/apis/automation-agent-for-premiere-pro-validation-api/revisions/cf90cd3e7e4b?raw)