Guardrails & Validation

The SDK exposes a single primary operation: validation.

Validation applies a Guardrail profile to content and returns a structured result.

Validation types

| Type | Description | | ------ | --------------------- | | input | Validate user input | | output | Validate model output |

const result = await client.validate({
  text: 'Hello world',
  profileName: 'default',
  validationType: 'input',
});

{
  passed: boolean;
  violations: GuardrailViolation[];
  executionTimeMs: number;
}

if (!result.passed) {
  result.violations.forEach((v) => {
    console.log(v.guardrail, v.message);
  });
}

Profiles control which guardrails run.

Examples:

Profiles can be managed in the dashboard or via API.

You can dynamically choose profiles:

const profile = user.isEnterprise ? 'enterprise_security' : 'default';
 
await client.validate({ text, profileName: profile });