Dry-run existing records against a schema

Run existing records of the type through a schema WITHOUT writing anything — powers the “N of M records would fail” preview before enabling enforce. Uses the request-body schema when provided (a proposal), otherwise the collection’s saved schema. Capped at 10,000 checked rows; truncated reports whether the cap was hit.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

slugstringRequired

Request

This endpoint expects an object.

schemamap from strings to anyOptional

Constrained JSON Schema dialect: root object with string/number/boolean/array/object properties, one nesting level, no $ref/oneOf/pattern

Response

Dry-run result

checkedinteger

exampleslist of objects

failedinteger

truncatedboolean

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X POST https://api.runtype.com/v1/collections/slug/validate-existing \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"checked": 1,
3	"examples": [
4	{
5	"errors": [
6	{
7	"code": "MISSING_REQUIRED_FIELD",
8	"field": "email",
9	"message": "The 'email' field is required but was not provided."
10	}
11	],
12	"name": "John Doe",
13	"recordId": "rec_1234567890abcdef"
14	}
15	],
16	"failed": 1,
17	"truncated": true
18	}