---
title: "Get metadata validation result"
method: POST
path: "/orgs/{orgId}/projects/{projectId}/scout/metadata/validate"
tags: ["Metadata"]
---

# Get metadata validation result

`POST /orgs/{orgId}/projects/{projectId}/scout/metadata/validate`

## Request

- Base URL: `https://app.cloud.redocly.com/api`
- URL: `https://app.cloud.redocly.com/api/orgs/{orgId}/projects/{projectId}/scout/metadata/validate`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/redocly/apis/redocly-scout/docs/orgs/:orgId/projects/:projectId/scout/metadata/validate/post.ts> (a function with typed inputs; its response is checked against the schema)

Validate api metadata against "metadataSchema" in project's config file.

## Path parameters

- `orgId` string, required
- `projectId` string, required

## Headers

- `x-redocly-scout-version` string

## Request body

- Metadata: Any object shape.

## Response `200`

OK.

- MetadataValidationResult
  - `isValid` boolean, required
  - `errors` object[]: Array of metadata validation errors.
    - `keyword` string, required: Validation keyword.
    - `instancePath` string, required: JSON Pointer to the location in the data instance.
    - `schemaPath` string, required: JSON Pointer to the location of the failing keyword in the schema.
    - `params` object, required: Additional information about error.
    - `propertyName` string: Set for errors in `propertyNames` keyword schema.
    - `message` string: Error message.
    - `schema` unknown
    - `parentSchema` object: Schema containing the keyword.
    - `data` unknown

## Other responses

- `400`: Bad Request.
- `404`: Resource not found.

---

[API](https://skmtc.dev/redocly/apis/redocly-scout.md) - [All operations](https://skmtc.dev/redocly/apis/redocly-scout/llms.txt) - [OpenAPI document](https://skmtc.dev/redocly/apis/redocly-scout/revisions/18944395275b?raw)