GET /accounts/{account_id}/r2-catalog/{bucket_name}/namespaces
Returns a list of namespaces in the specified R2 catalog. Supports hierarchical filtering and pagination for efficient traversal of large namespace hierarchies.
Servers
- https://api.cloudflare.com/client/v4
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
bucket_name |
String | Yes |
Specifies the R2 bucket name. |
account_id |
String | Yes |
Identifies the account. |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
parent |
String | No |
Parent namespace to filter by. Only returns direct children of this namespace. For nested namespaces, use %1F as separator (e.g., "bronze%1Fanalytics"). Omit this parameter to list top-level namespaces. |
return_uuids |
Boolean | No |
Whether to include namespace UUIDs in the response. Set to true to receive the namespace_uuids array. Default value: false |
return_details |
Boolean | No |
Whether to include additional metadata (timestamps). When true, response includes created_at and updated_at arrays. Default value: false |
page_size |
Integer | No |
Maximum number of namespaces to return per page. Defaults to 100, maximum 1000. Default value: 100 |
page_token |
String | No |
Opaque pagination token from a previous response. Use this to fetch the next page of results. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.