---
title: "Update bucket settings"
method: PUT
path: "/api/buckets/{namespace}/{repo}/settings"
tags: ["buckets"]
---

# Update bucket settings

`PUT /api/buckets/{namespace}/{repo}/settings`

## Path parameters

- `namespace` string, required
- `repo` string, required

## Request body

- object
  - `private` union
    - boolean
    - string
  - `cdnRegions` object[]
    - `provider` 'gcp' | 'aws', required
    - `region` 'us' | 'eu', required

## Response `200`

The updated bucket settings.

- object
  - `private` boolean
  - `cdnRegions` object[]
    - `provider` 'gcp' | 'aws', required
    - `region` 'us' | 'eu', required

## Changes

- **2026-09-08** `bd17546f47b8` — 7 breaking, 2 info
  - removed `subschema #1, subschema #2` from the `private` request property `anyOf` list
  - the `cdnRegions/items/provider` request property type changed from no type to `string`
  - the `cdnRegions/items/region` request property type changed from no type to `string`
  - the `private` request property type changed from no type to `boolean, string`
  - …5 more

[Change history](https://skmtc.dev/huggingface/apis/hub-api-endpoints/changes/api/buckets/:namespace/:repo/settings/put.md)

---

[API](https://skmtc.dev/huggingface/apis/hub-api-endpoints.md) · [All operations](https://skmtc.dev/huggingface/apis/hub-api-endpoints/llms.txt) · [OpenAPI document](https://skmtc.dev/huggingface/apis/hub-api-endpoints/revisions/ea15a26e9ab3?raw)