Sample Source Rows
GET/api/v1/schemas/:source_name/sample-rows
Return random sample rows for a source, scoped to its match rule.
Resolves the requested version (or the source's current version). A
version with a meta_schema uses db.<source> only after that version
is deployed and the table exists. Otherwise rows are read from
db.<landing> filtered by the version's match rule.
Intended for inspecting real data while authoring a match condition or CEL
before promoting any JSON path -- a row-level companion to the per-path
?samples=N on /json-paths.
A caller without a platform grant holding schema:read reads only its own
orgs' rows, as the sampler holds it, and a table it cannot be held on is 403.
Request
Responses
- 200
- 401
- 403
- 422
- default
Successful Response
No valid session: the credentials are missing, invalid or expired, or the account behind them is disabled or blocked
Refused: the session lacks the action this route checks, or its account must replace an issued password first. A SCIM route answers a refused action in the RFC 7644 error envelope
Validation Error
Problem details (RFC 9457)