---
title: "Assign Bulk Browse"
method: POST
path: "/v2/polaris/principals/{principal_name}/bulk-browse"
tags: ["Polaris"]
---

# Assign Bulk Browse

`POST /v2/polaris/principals/{principal_name}/bulk-browse`

Assign the catalog browse/list roles (``sample_ro_list_role`` and
``bulk_ro_list_role``) to the principal.

Called by CAMS at block-enable. Tolerant per role: if a role isn't seeded in
this environment, logs a warning and reports ``assigned=False`` for it
(HTTP 200). These are list-only roles — they grant catalog browsing, never
data read (which stays per-SKU default-deny).

## Path parameters

- `principal_name` string, required

## Response `200`

Successful Response

- BulkBrowseResponse
  - `principal_name` string, required
  - `roles` BrowseRoleResult[], required
    - `role` string, required
    - `assigned` 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/revisions/4850d81778a4/schema)