---
title: "Revoke Dataset Access"
method: POST
path: "/v2/polaris/datasets/{dataset_id}/revoke"
tags: ["Polaris"]
---

# Revoke Dataset Access

`POST /v2/polaris/datasets/{dataset_id}/revoke`

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.

## Path parameters

- `dataset_id` string, required

## Request body

- RevokeDatasetRequest
  - `principal_name` string, required
  - `catalog` string, required — Catalog of the SKU to revoke (e.g. 'sample', 'bulk'). Required — the exact SKU comes from the caller; power-api never infers it.
  - `lag` string, nullable
  - `cut` string, nullable

## Response `200`

Successful Response

- RevokeDatasetResponse
  - `dataset_id` string, required
  - `principal_name` string, required
  - `principal_role` string, required
  - `catalog_role` string, required
  - `catalog` string, required
  - `revoked` boolean, required

## Other responses

- `404` — Not Found
- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-api-documentation.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-api-documentation/versions/bd33ea42994c/schema)