Validate Harbor Saved Query Draft

Beta

POST

https://app.polytomic.com/api/harbors/:harbor_id/saved-queries/:saved_query_id/draft/validate

Validates the exact current saved-query draft and returns a bounded ephemeral preview.

Only organization administrators can validate drafts. Named template references compile to DuckDB placeholders, and typed values are passed separately rather than interpolated into SQL.

The query runs with the Polytomic-managed Harbor’s MotherDuck read_scaling credential. Validation fails when that credential is missing or incomplete and never falls back to the Harbor writer credential. Preview rows and serialized response size are bounded. The preview and validation attempt are not persisted.

Validates the exact current saved-query draft and returns a bounded ephemeral preview. Only organization administrators can validate drafts. Named template references compile to DuckDB placeholders, and typed values are passed separately rather than interpolated into SQL. The query runs with the Polytomic-managed Harbor's MotherDuck `read_scaling` credential. Validation fails when that credential is missing or incomplete and never falls back to the Harbor writer credential. Preview rows and serialized response size are bounded. The preview and validation attempt are not persisted.

Authentication

AuthorizationBearer

Bearer user API key

AuthorizationBasic

Basic organization-scoped API key

Path parameters

harbor_idstringRequiredformat: "uuid"

Unique identifier of the Harbor.

saved_query_idstringRequiredformat: "uuid"

Unique stable identifier of the saved query.

Response

dataobjectOptional

Errors

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error

Authentication

Path parameters

Headers

Response

Errors