Rensei docs
API ReferenceWorkflows

Validate the current stored workflow without writing or executing it.

Checks one freshly authorized saved workflow snapshot under the existing project and Cedar edit-workflow decision. A valid result covers only the compiler checks represented by this endpoint; it does not establish publish, execution, or recipient readiness.

POST
/api/workflows/{id}/validate

Authorization

headerAuthorizationBearer <rsk_live_*>

Rensei API key presented as Authorization: Bearer rsk_live_. Required API-key scopes are recorded per operation in x-rensei-required-scopes.

Path Parameters

id*string

Saved workflow id.

Length1 <= length

Response Body

The saved workflow was authorized and compiled. The verdict is in the body, never the status: valid reports whether it passed the compiler checks represented by this endpoint, errors carries the compiler diagnostics, and warnings is present only when non-empty. An invalid workflow is still a 200 — reporting what is wrong with a draft is this endpoint's purpose, not a failed request.

application/json
  1. response
valid*boolean
errors*array<>
warnings?array<>
Example Request
curl -X POST 'https://app.rensei.ai/api/workflows/string/validate'
Example Response
{  "valid": true,  "errors": [    {      "code": "string",      "severity": "error",      "phase": "string",      "path": "string",      "message": "string",      "remediation": "string",      "line": 1,      "column": 1    }  ],  "warnings": [    {      "code": "string",      "severity": "error",      "phase": "string",      "path": "string",      "message": "string",      "remediation": "string",      "line": 1,      "column": 1    }  ]}