Skip to main content
POST
Validate an automation primitive input

Authorizations

Authorization
string
header
required

Passport bearer token authentication for legacy admin sessions.

Path Parameters

name
string
required

Exact dot-separated operation name returned by primitive discovery; route names accept lowercase letters, underscores and dots.

Pattern: ^[a-z._]+$

Body

application/json

Input accepted by the selected primitive.

Operation-specific input object; use GET /primitives/{name}/schema to discover its properties and required fields.

{key}
any

Response

Operation result; data and metadata follow the selected primitive contract.

The PrimitiveResult envelope serialized by primitive invocation and validation.

success
boolean
required

Whether the selected primitive succeeded.

Example:

true

data
any | null
required

Operation-specific JSON result, or null on failure. Its schema is returned by primitive discovery.

errors
object[]
required

Domain errors or validation field errors.

warnings
string[]
required

Non-fatal operation warnings.

meta
any
required

Operation metadata; may contain status, dry_run, replay information or pagination. Empty metadata serializes as an empty array.