Skip to main content
POST
cURL

Authorizations

X-API-KEY
string
header
required

API key authentication. Get your API key from the Formal console.

Body

application/json
naturalLanguagePrompt
string

Natural language description of the desired workflow. May include context such as existing YAML code, validation errors, or org context composed by the caller.

Required string length: 1 - 10000
skipRetryOnInvalid
boolean

When true, the code is still validated but the retry loop is skipped on validation failure. The response will contain accurate valid/validation_error fields regardless. Useful when the caller wants to inspect invalid code (e.g. to explain why it fails). Defaults to false (retry up to 3 times on validation failure).

Response

Success

code
string
name
string
description
string
valid
boolean
validationError
string