# Validate a configuration manifest

`POST https://api.cademi.com.br/api/v3/configuration/validations`

Operation ID: `configuration.validations.create` · API v3

Validates a configuration manifest without modifying any resource.

Content problems, such as invalid fields or unresolved references, are reported in the validation report, and the response status is still `200`. Check the `valid` field to determine the result.

The request is rejected with `422` only when the manifest cannot be evaluated: `too_many_items` when it exceeds the maximum number of resources, and `unsupported_resource` when it contains an unsupported resource kind.

Required permissions: `configuration.validate`.

## Request body

Content type: `application/json`, required.

| Field | Type | Required | Description |
|---|---|---|---|
| `$schema` | string | no |  |
| `order` | object | no | Ordered sets keyed by set name (for example, showcases or menu_items). Each value must be the complete list for its scope. |
| `resources` | array of object | yes |  |

## Responses

### 200

Returns the validation report for the manifest.

Body: `data`: Validation.

Fields of Validation:

| Field | Type | Required | Description |
|---|---|---|---|
| `errors` | array of object | yes |  |
| `object` | string, one of `validation` | yes |  |
| `required_capabilities` | array of string | yes |  |
| `unsupported` | array of string | yes |  |
| `valid` | boolean | yes |  |
| `warnings` | array of object | yes |  |

### 401

The credential is missing, malformed, expired, or revoked.

Body: Error.

### 403

The current credentials do not have the permission required by this operation.

Body: Error.

### 422

The request body or query parameters failed validation.

Body: ValidationFailed.

Full schema: https://cademi.dev/openapi/v3.json