Skip to content

Get metadata validation result

Request

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

Security
ApiKey
Path
orgIdstringrequired

Organization ID.

Example:acme-inc
projectIdstringrequired

Project ID.

Example:my-project
Headers
x-redocly-scout-versionstring

Scout version.

Example:1.0.0
Bodyapplication/json
object(Metadata)

Any object shape.

curl -i -X POST \
  https://redocly.com/_mock/docs/realm/scout/api/openapi/orgs/acme-inc/projects/my-project/scout/metadata/validate \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'x-redocly-scout-version: 1.0.0' \
  -d '{
    "department": "IT"
  }'

Responses

OK.

Bodyapplication/json
isValidbooleanrequired
Example:false
errorsArray of objects

Array of metadata validation errors.

Example:
[
  {
    "instancePath": "",
    "schemaPath": "#/required",
    "keyword": "required",
    "params": { … },
    "message": "must have required property 'owner'"
  }
]
Response
{
  "isValid": false,
  "errors": [
    { … }
  ]
}