v3

latestOpenAPI 3.1.02026-07-31115157197.4 KB
Polaris

Revoke Dataset Access

Detach a dataset's catalog role from a principal's per-client role.

The SKU — including its catalog — comes entirely from the request; the graph is never consulted. Idempotent: detaching a role that isn't attached returns revoked=False. The catalog role itself is preserved (other principals may share it); orphaned roles are the reconciler's job.

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

Path parameters

dataset_idstring required

Request body

principal_namestring required
catalogstring required

Catalog of the SKU to revoke (e.g. 'sample', 'bulk'). Required — the exact SKU comes from the caller; power-api never infers it.

lagstring nullable
cutstring nullable

Response

Successful Response

dataset_idstring required
principal_namestring required
principal_rolestring required
catalog_rolestring required
catalogstring required
revokedboolean required