# cbValidation

## v1.x

- [Introduction](https://coldbox-validation.ortusbooks.com/v1.x/master.md)
- [Installation](https://coldbox-validation.ortusbooks.com/v1.x/overview/installation.md)
- [Configuration](https://coldbox-validation.ortusbooks.com/v1.x/overview/configuration.md)
- [Declaring Constraints](https://coldbox-validation.ortusbooks.com/v1.x/overview/declaring-constraints.md)
- [Configuration File](https://coldbox-validation.ortusbooks.com/v1.x/overview/declaring-constraints/configuration-file.md)
- [Domain Object](https://coldbox-validation.ortusbooks.com/v1.x/overview/declaring-constraints/domain-object.md)
- [A-la-carte](https://coldbox-validation.ortusbooks.com/v1.x/overview/declaring-constraints/a-la-carte-via-event-handlers.md)
- [Available Constraints](https://coldbox-validation.ortusbooks.com/v1.x/overview/valid-constraints.md)
- [Unique Constraints](https://coldbox-validation.ortusbooks.com/v1.x/overview/valid-constraints/unique-constraints.md)
- [Constraint Custom Messages](https://coldbox-validation.ortusbooks.com/v1.x/overview/valid-constraints/constraint-custom-messages.md)
- [Custom Message Replacements](https://coldbox-validation.ortusbooks.com/v1.x/overview/valid-constraints/custom-message-replacements.md)
- [Validating Constraints](https://coldbox-validation.ortusbooks.com/v1.x/overview/validating-constraints.md)
- [Validating With Failures](https://coldbox-validation.ortusbooks.com/v1.x/overview/validating-constraints/validating-with-failures.md)
- [Validating with shared constraints](https://coldbox-validation.ortusbooks.com/v1.x/overview/validating-constraints/validating-with-shared-constraints.md)
- [Validating with a-la-carte constraints](https://coldbox-validation.ortusbooks.com/v1.x/overview/validating-constraints/validating-with-a-la-carte-constraints.md)
- [Validating Custom Fields](https://coldbox-validation.ortusbooks.com/v1.x/overview/validating-constraints/validating-custom-fields.md)
- [Displaying Errors](https://coldbox-validation.ortusbooks.com/v1.x/overview/displaying-errors.md)
- [WireBox DSL & Integration](https://coldbox-validation.ortusbooks.com/v1.x/overview/wirebox-dsl-and-integration.md)
- [i18n Integration](https://coldbox-validation.ortusbooks.com/v1.x/advanced/i18n-integration.md)
- [Advanced Custom Validators](https://coldbox-validation.ortusbooks.com/v1.x/advanced/advanced-custom-validators.md)
- [Custom Validators](https://coldbox-validation.ortusbooks.com/v1.x/advanced/custom-validators.md)
- [Custom Validation Managers](https://coldbox-validation.ortusbooks.com/v1.x/advanced/custom-validation-managers.md)

## v2.x

- [Introduction](https://coldbox-validation.ortusbooks.com/v2.x/master.md)
- [Release History](https://coldbox-validation.ortusbooks.com/v2.x/intro/release-history.md)
- [What's New With 2.1.0](https://coldbox-validation.ortusbooks.com/v2.x/intro/release-history/whats-new-with-2.1.0.md)
- [What's New With 2.0.0](https://coldbox-validation.ortusbooks.com/v2.x/intro/release-history/whats-new-with-2.0.0.md)
- [About This Book](https://coldbox-validation.ortusbooks.com/v2.x/intro/about-this-book.md)
- [Author](https://coldbox-validation.ortusbooks.com/v2.x/intro/about-this-book/author.md)
- [Installation](https://coldbox-validation.ortusbooks.com/v2.x/overview/installation.md)
- [Configuration](https://coldbox-validation.ortusbooks.com/v2.x/overview/configuration.md)
- [Declaring Constraints](https://coldbox-validation.ortusbooks.com/v2.x/overview/declaring-constraints.md)
- [Configuration File](https://coldbox-validation.ortusbooks.com/v2.x/overview/declaring-constraints/configuration-file.md): Shared Constraints
- [Domain Object](https://coldbox-validation.ortusbooks.com/v2.x/overview/declaring-constraints/domain-object.md)
- [A-la-carte](https://coldbox-validation.ortusbooks.com/v2.x/overview/declaring-constraints/a-la-carte-via-event-handlers.md)
- [Available Constraints](https://coldbox-validation.ortusbooks.com/v2.x/overview/valid-constraints.md)
- [Custom Message Replacements](https://coldbox-validation.ortusbooks.com/v2.x/overview/valid-constraints/custom-message-replacements.md)
- [Constraint Custom Messages](https://coldbox-validation.ortusbooks.com/v2.x/overview/valid-constraints/constraint-custom-messages.md)
- [Validating Constraints](https://coldbox-validation.ortusbooks.com/v2.x/overview/validating-constraints.md)
- [Validating With Failures](https://coldbox-validation.ortusbooks.com/v2.x/overview/validating-constraints/validating-with-failures.md)
- [Validating with shared constraints](https://coldbox-validation.ortusbooks.com/v2.x/overview/validating-constraints/validating-with-shared-constraints.md)
- [Validating with a-la-carte constraints](https://coldbox-validation.ortusbooks.com/v2.x/overview/validating-constraints/validating-with-a-la-carte-constraints.md)
- [Validating Custom Fields](https://coldbox-validation.ortusbooks.com/v2.x/overview/validating-constraints/validating-custom-fields.md)
- [Validating With Profiles](https://coldbox-validation.ortusbooks.com/v2.x/overview/validating-constraints/validating-with-profiles.md)
- [Displaying Errors](https://coldbox-validation.ortusbooks.com/v2.x/overview/displaying-errors.md)
- [WireBox Integration](https://coldbox-validation.ortusbooks.com/v2.x/overview/wirebox-dsl-and-integration.md)
- [Custom Validators](https://coldbox-validation.ortusbooks.com/v2.x/advanced/advanced-custom-validators.md)
- [Unique ORM Validator](https://coldbox-validation.ortusbooks.com/v2.x/advanced/unique-constraints.md)
- [i18n Integration](https://coldbox-validation.ortusbooks.com/v2.x/advanced/i18n-integration.md)
- [Custom Validation Managers](https://coldbox-validation.ortusbooks.com/v2.x/advanced/custom-validation-managers.md)

## v3.x

- [Introduction](https://coldbox-validation.ortusbooks.com/v3.x-1/readme.md)
- [Release History](https://coldbox-validation.ortusbooks.com/v3.x-1/intro/release-history.md)
- [What's New With 3.3.0](https://coldbox-validation.ortusbooks.com/v3.x-1/intro/release-history/whats-new-with-3.3.0.md): 2022-JAN-12
- [What's New With 3.2.0](https://coldbox-validation.ortusbooks.com/v3.x-1/intro/release-history/whats-new-with-3.2.0.md): 2021-NOV-12
- [What's New With 3.1.0](https://coldbox-validation.ortusbooks.com/v3.x-1/intro/release-history/whats-new-with-3.1.0.md): 2021-MAY-15
- [What's New With 3.0.0](https://coldbox-validation.ortusbooks.com/v3.x-1/intro/release-history/whats-new-with-3.0.0.md)
- [What's New With 2.1.0](https://coldbox-validation.ortusbooks.com/v3.x-1/intro/release-history/whats-new-with-2.1.0.md)
- [What's New With 2.0.0](https://coldbox-validation.ortusbooks.com/v3.x-1/intro/release-history/whats-new-with-2.0.0.md)
- [About This Book](https://coldbox-validation.ortusbooks.com/v3.x-1/intro/about-this-book.md)
- [Author](https://coldbox-validation.ortusbooks.com/v3.x-1/intro/about-this-book/author.md)
- [Installation](https://coldbox-validation.ortusbooks.com/v3.x-1/overview/installation.md)
- [Configuration](https://coldbox-validation.ortusbooks.com/v3.x-1/overview/configuration.md)
- [Declaring Constraints](https://coldbox-validation.ortusbooks.com/v3.x-1/overview/declaring-constraints.md)
- [Configuration File](https://coldbox-validation.ortusbooks.com/v3.x-1/overview/declaring-constraints/configuration-file.md): Shared Constraints
- [Domain Object](https://coldbox-validation.ortusbooks.com/v3.x-1/overview/declaring-constraints/domain-object.md)
- [A-la-carte](https://coldbox-validation.ortusbooks.com/v3.x-1/overview/declaring-constraints/a-la-carte-via-event-handlers.md)
- [Available Constraints](https://coldbox-validation.ortusbooks.com/v3.x-1/overview/valid-constraints.md)
- [Custom Message Replacements](https://coldbox-validation.ortusbooks.com/v3.x-1/overview/valid-constraints/custom-message-replacements.md)
- [Constraint Custom Messages](https://coldbox-validation.ortusbooks.com/v3.x-1/overview/valid-constraints/constraint-custom-messages.md)
- [Nested Struct and Array Field Name Shortcuts](https://coldbox-validation.ortusbooks.com/v3.x-1/overview/valid-constraints/nested-struct-and-array-field-name-shortcuts.md)
- [Validating Constraints](https://coldbox-validation.ortusbooks.com/v3.x-1/overview/validating-constraints.md)
- [Validating With Failures](https://coldbox-validation.ortusbooks.com/v3.x-1/overview/validating-constraints/validating-with-failures.md)
- [Validating with shared constraints](https://coldbox-validation.ortusbooks.com/v3.x-1/overview/validating-constraints/validating-with-shared-constraints.md)
- [Validating with a-la-carte constraints](https://coldbox-validation.ortusbooks.com/v3.x-1/overview/validating-constraints/validating-with-a-la-carte-constraints.md)
- [Validating Custom Fields](https://coldbox-validation.ortusbooks.com/v3.x-1/overview/validating-constraints/validating-custom-fields.md)
- [Validating With Profiles](https://coldbox-validation.ortusbooks.com/v3.x-1/overview/validating-constraints/validating-with-profiles.md)
- [Displaying Errors](https://coldbox-validation.ortusbooks.com/v3.x-1/overview/displaying-errors.md)
- [WireBox Integration](https://coldbox-validation.ortusbooks.com/v3.x-1/overview/wirebox-dsl-and-integration.md)
- [Custom Validators](https://coldbox-validation.ortusbooks.com/v3.x-1/advanced/advanced-custom-validators.md)
- [Unique ORM Validator](https://coldbox-validation.ortusbooks.com/v3.x-1/advanced/unique-constraints.md)
- [i18n Integration](https://coldbox-validation.ortusbooks.com/v3.x-1/advanced/i18n-integration.md)
- [Custom Validation Managers](https://coldbox-validation.ortusbooks.com/v3.x-1/advanced/custom-validation-managers.md)

## v4.x

- [Introduction](https://coldbox-validation.ortusbooks.com/readme.md): cbValidation is the server-side validation engine for ColdBox applications
- [Release History](https://coldbox-validation.ortusbooks.com/intro/release-history.md): This section contains the release history for CBValidation module.
- [What's New With 4.8.0](https://coldbox-validation.ortusbooks.com/intro/release-history/whats-new-with-4.8.0.md): Unreleased
- [What's New With 4.7.0](https://coldbox-validation.ortusbooks.com/intro/release-history/whats-new-with-4.7.0.md): October 13, 2025
- [What's New With 4.6.0](https://coldbox-validation.ortusbooks.com/intro/release-history/whats-new-with-4.6.0.md): September 18, 2025
- [What's New With 4.5.0](https://coldbox-validation.ortusbooks.com/intro/release-history/whats-new-with-4.5.0.md): February 19, 2025
- [What's New With 4.4.0](https://coldbox-validation.ortusbooks.com/intro/release-history/whats-new-with-4.4.0.md): October 16, 2023
- [What's New With 4.3.1](https://coldbox-validation.ortusbooks.com/intro/release-history/whats-new-with-4.3.1.md): June 15, 2023
- [What's New With 4.3.0](https://coldbox-validation.ortusbooks.com/intro/release-history/whats-new-with-4.3.0.md): May 5, 2023
- [What's New With 4.2.0](https://coldbox-validation.ortusbooks.com/intro/release-history/whats-new-with-4.2.0.md): April 14, 2023
- [What's New With 4.1.0](https://coldbox-validation.ortusbooks.com/intro/release-history/whats-new-with-4.1.0.md): November 15, 2022
- [What's New With 4.0.0](https://coldbox-validation.ortusbooks.com/intro/release-history/whats-new-with-3.0.0.md): October 10, 2022
- [About This Book](https://coldbox-validation.ortusbooks.com/intro/about-this-book.md): Information about the cbValidation documentation book, contribution guidelines, and copyright.
- [Author](https://coldbox-validation.ortusbooks.com/intro/about-this-book/author.md): Information about the authors of the cbValidation module.
- [Installation](https://coldbox-validation.ortusbooks.com/overview/installation.md): Get CBValidation installed in your ColdBox application and configure it for validation workflows.
- [Configuration](https://coldbox-validation.ortusbooks.com/overview/configuration.md): Configuration options for CBValidation module.
- [Available Constraints](https://coldbox-validation.ortusbooks.com/overview/valid-constraints.md)
- [Custom Message Replacements](https://coldbox-validation.ortusbooks.com/overview/valid-constraints/custom-message-replacements.md)
- [Constraint Custom Messages](https://coldbox-validation.ortusbooks.com/overview/valid-constraints/constraint-custom-messages.md)
- [Nested Struct-Array Field Names](https://coldbox-validation.ortusbooks.com/overview/valid-constraints/nested-struct-and-array-field-name-shortcuts.md)
- [Declaring Constraints](https://coldbox-validation.ortusbooks.com/overview/declaring-constraints.md): Learn how to declare constraints for your data validation needs using cbValidation.
- [Configuration File](https://coldbox-validation.ortusbooks.com/overview/declaring-constraints/configuration-file.md): Shared Constraints
- [Domain Object](https://coldbox-validation.ortusbooks.com/overview/declaring-constraints/domain-object.md)
- [A-la-carte](https://coldbox-validation.ortusbooks.com/overview/declaring-constraints/a-la-carte-via-event-handlers.md)
- [Validating Constraints](https://coldbox-validation.ortusbooks.com/overview/validating-constraints.md)
- [Validating With Failures](https://coldbox-validation.ortusbooks.com/overview/validating-constraints/validating-with-failures.md)
- [Validating with shared constraints](https://coldbox-validation.ortusbooks.com/overview/validating-constraints/validating-with-shared-constraints.md)
- [Validating with a-la-carte constraints](https://coldbox-validation.ortusbooks.com/overview/validating-constraints/validating-with-a-la-carte-constraints.md)
- [Validating Custom Fields](https://coldbox-validation.ortusbooks.com/overview/validating-constraints/validating-custom-fields.md)
- [Validating With Profiles](https://coldbox-validation.ortusbooks.com/overview/validating-constraints/validating-with-profiles.md): Advanced constraint profiles for targeted validation scenarios
- [Using Default Values](https://coldbox-validation.ortusbooks.com/overview/validating-constraints/using-default-values.md): Using default values in constraints
- [Displaying Errors](https://coldbox-validation.ortusbooks.com/overview/displaying-errors.md)
- [Using the Assert Helper](https://coldbox-validation.ortusbooks.com/overview/using-the-assert-helper.md): Using the assert() helper method
- [Null Value Handling](https://coldbox-validation.ortusbooks.com/advanced/null-value-handling.md): Understanding null value handling in validation
- [Validatable Delegate](https://coldbox-validation.ortusbooks.com/advanced/validatable-delegate.md): Using the Validatable delegate for object validation
- [Custom Validators](https://coldbox-validation.ortusbooks.com/advanced/advanced-custom-validators.md)
- [Custom Validation Managers](https://coldbox-validation.ortusbooks.com/advanced/custom-validation-managers.md)
- [Unique ORM Validator](https://coldbox-validation.ortusbooks.com/advanced/unique-constraints.md)
- [i18n Integration](https://coldbox-validation.ortusbooks.com/advanced/i18n-integration.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
This site has an agentic ask interface you may use to query the documentation dynamically by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://coldbox-validation.ortusbooks.com/index.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.