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 |

Basic validation

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

Validation response

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

Handling failures

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

Profiles

Profiles control which guardrails run.

Examples:

• default
• enterprise_security
• child_safety
• minimal

Profiles can be managed in the dashboard or via API.

Advanced usage

You can dynamically choose profiles:

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

Next steps

• See full integrations → Examples