agents1

auth1

blogs3

buckets15

collections20

containers12

datasets37

discussions36

docs3

inference-endpoints2

inference-providers7

jobs23

kernels6

models37

notifications5

oauth4

orgs15

papers7

repo-search3

repos4

resource-groups9

scim28

service-accounts8

spaces48

sql-console3

tokens1

users16

webhooks7

buckets

List namespace buckets

get/api/buckets/{namespace}

Path parameters

namespacestring required

Query parameters

searchstring

Response

List of buckets

_idstring required

A hex string of 24 characters representing an ObjectId.

authorstring required

idstring required

privateboolean nullable

descriptionstring nullable

Free-text description of the bucket / container image

createdAtstring date-time required

updatedAtstring date-time required

Moves on every successful change to the bucket's files. Poll it to know when to re-list instead of re-listing every path.

sizenumber required

The amount of storage used by the bucket in bytes

totalFilesnumber required

The total number of files in the bucket

repoType'bucket' | 'container' required

adminTagsstring[]

Changes

Changed in 4 of the 82 revisions of this API.526

Sep 23, 2026ea15a26e9ab31See the full diff
- ○
  added the optional property / to the response with the status
  response-optional-property-added
Sep 18, 202674f2b0d1763612See the full diff
- ▲
  the response property const value bucket was removed for the status
  response-property-const-removed
- ●
  added the new bucket enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new container enum value to the / response property for the response status
  response-property-enum-value-added
Sep 8, 2026bd17546f47b843See the full diff
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the /// response's property type changed from no type to string for status
  response-property-type-changed
- ▲
  the /// response's property type changed from no type to string for status
  response-property-type-changed
- ▲
  the / response's property type changed from no type to string for status
  response-property-type-changed
- ○
  response property items/private list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  the / response's property pattern was changed from ^((\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-((0[13578]|1[02])-(0[1-9]|[12]\d|3[01])|(0[469]|11)-(0[1-9]|[12]\d|30)|(02)-(0[1-9]|1\d|2[0-8])))T([01]\d|2[0-3]):[0-5]\d:[0-5]\d(\.\d+)?(Z)$ to ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ for the status
  response-property-pattern-changed
- ○
  the / response's property pattern was changed from ^((\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-((0[13578]|1[02])-(0[1-9]|[12]\d|3[01])|(0[469]|11)-(0[1-9]|[12]\d|30)|(02)-(0[1-9]|1\d|2[0-8])))T([01]\d|2[0-3]):[0-5]\d:[0-5]\d(\.\d+)?(Z)$ to ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ for the status
  response-property-pattern-changed
Jul 26, 202636390f25f00f2See the full diff
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added

Full history