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

Request

  • Base URL: https://api.carbonarc.co (the document declares no server; this is the origin it was published from)
  • URL: https://api.carbonarc.co/v2/polaris/datasets/{dataset_id}/grant
  • Auth: none declared

Path parameters

dataset_idstring required

Request body

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.

Response

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

Changes

No recorded changes to this operation across all 13 revisions of this API.