Validate a Node Configuration

Use this endpoint to check a workflow node’s configuration against the JSON Schema of the catalog executor it invokes. The check is structural — it never calls the external service.

POST /v1/catalog/executors/{id}/validate

Validate a Node Configuration

cURL

curl --request POST \
  --url https://flowker.sandbox.lerian.net/v1/catalog/executors/{id}/validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "config": {
    "method": "POST",
    "path": "/score-transaction"
  },
  "mappedTargets": [
    "accountId"
  ]
}
'

200

{
  "error": "",
  "valid": true
}

Authorizations

Authorization · string · header · required

JWT bearer token issued by the identity provider. Send it in the Authorization header as Bearer <token>.

Path Parameters

id · string · required

Unique identifier of the catalog executor.

Body

application/json

Request body containing the configuration to validate.

config · object · required

The node configuration to check against the catalog executor's JSON Schema.

Show child attributes

Example:

{
  "method": "POST",
  "path": "/score-transaction"
}

mappedTargets · string[] | null

Field paths the node supplies through an inputMapping instead of a fixed value in config. Flowker counts them as satisfied, so a node that maps a required field from the trigger or from an earlier step passes the check. Omit the field to check config on its own.

Example:

["accountId"]

Response

200

application/json

Indicates that the request was successful and the response contains the requested data.

error · string

Validation error message. Empty when valid.

Example:

""

valid · boolean

Whether the configuration passed validation.

Example:

true