latestOpenAPI 3.1.02026-08-21134175230.7 KB

4850d81778a4

Polaris

Grant Dataset Access

Grant a principal read access to every table under a dataset SKU.

Idempotent. The catalog is taken from the request — it scopes table resolution and the catalog-role name.

post/v2/polaris/datasets/{dataset_id}/grant

dataset_idstring required

principal_namestring required

catalogstring required

Catalog the SKU belongs to (e.g. 'sample', 'bulk'). Scopes table resolution and the catalog-role name; no longer inferred from rows.

lagstring nullable

Lag of the dataset to grant access to. Omit (or null) for the no-lag variant — graph stores no-lag rows with lag=null.

cutstring nullable

Cut of the dataset to grant access to. Omit (or null) for the no-cut variant — graph stores no-cut rows with cut=null.

Successful Response

dataset_idstring required

principal_namestring required

principal_rolestring required

catalog_rolestring required

catalogstring required

tables_grantedinteger required

tables_skippedinteger required

skipped_catalogsstring[] required