--- title: Namespaces --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Basin Catalog](https://developers.cloudflare.com/api/resources/basin_catalog) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Namespaces ##### [List namespaces in catalog](https://developers.cloudflare.com/api/resources/basin_catalog/subresources/namespaces/methods/list) GET/accounts/{account\_id}/basin-catalog/{bucket\_name}/namespaces ##### ModelsExpand Collapse

NamespaceListResponse object {namespaces, details, namespace\_uuids, next\_page\_token } Contains the list of namespaces with optional pagination.

namespaces: array of array of string Lists namespaces in the catalog. Link to this property

details: optional array of object {namespace, namespace\_uuid, created\_at, updated\_at } Contains detailed metadata for each namespace when return\_details is true. Each object includes the namespace, UUID, and timestamps.

namespace: array of string Specifies the hierarchical namespace parts as an array of strings. For example, \[“bronze”, “analytics”] represents the namespace “bronze.analytics”. Link to this property namespace\_uuid: string Contains the UUID that persists across renames. formatuuid Link to this property created\_at: optional string Indicates the creation timestamp in ISO 8601 format. formatdate-time Link to this property updated\_at: optional string Shows the last update timestamp in ISO 8601 format. Null if never updated. formatdate-time Link to this property

Link to this property namespace\_uuids: optional array of string Contains UUIDs for each namespace when return\_uuids is true. The order corresponds to the namespaces array. Link to this property next\_page\_token: optional string Use this opaque token to fetch the next page of results. A null or absent value indicates the last page. Link to this property

[Link to this property](<#(resource)%20basin_catalog.namespaces%20%3E%20(model)%20namespace_list_response%20%3E%20(schema)>) #### NamespacesTables ##### [List tables in namespace](https://developers.cloudflare.com/api/resources/basin_catalog/subresources/namespaces/subresources/tables/methods/list) GET/accounts/{account\_id}/basin-catalog/{bucket\_name}/namespaces/{namespace}/tables ##### ModelsExpand Collapse

TableListResponse object {identifiers, details, next\_page\_token, table\_uuids } Contains the list of tables with optional pagination.

identifiers: array of object {name, namespace } Lists tables in the namespace.

name: string Specifies the table name. Link to this property namespace: array of string Specifies the hierarchical namespace parts as an array of strings. For example, \[“bronze”, “analytics”] represents the namespace “bronze.analytics”. Link to this property

Link to this property

details: optional array of object {identifier, table\_uuid, created\_at, 3 more } Contains detailed metadata for each table when return\_details is true. Each object includes identifier, UUID, timestamps, and locations.

identifier: object {name, namespace } Specifies a unique table identifier within a catalog.

Link to this property table\_uuid: string Contains the UUID that persists across renames. formatuuid Link to this property created\_at: optional string Indicates the creation timestamp in ISO 8601 format. formatdate-time Link to this property location: optional string Specifies the base S3 URI for table storage location. Link to this property metadata\_location: optional string Contains the S3 URI to table metadata file. Null for staged tables. Link to this property updated\_at: optional string Shows the last update timestamp in ISO 8601 format. Null if never updated. formatdate-time Link to this property

Link to this property next\_page\_token: optional string Use this opaque token to fetch the next page of results. A null or absent value indicates the last page. Link to this property table\_uuids: optional array of string Contains UUIDs for each table when return\_uuids is true. The order corresponds to the identifiers array. Link to this property

[Link to this property](<#(resource)%20basin_catalog.namespaces.tables%20%3E%20(model)%20table_list_response%20%3E%20(schema)>) #### NamespacesTablesMaintenance Configs ##### [Get table maintenance configuration](https://developers.cloudflare.com/api/resources/basin_catalog/subresources/namespaces/subresources/tables/subresources/maintenance_configs/methods/get) GET/accounts/{account\_id}/basin-catalog/{bucket\_name}/namespaces/{namespace}/tables/{table\_name}/maintenance-configs ##### [Update table maintenance configuration](https://developers.cloudflare.com/api/resources/basin_catalog/subresources/namespaces/subresources/tables/subresources/maintenance_configs/methods/update) POST/accounts/{account\_id}/basin-catalog/{bucket\_name}/namespaces/{namespace}/tables/{table\_name}/maintenance-configs ##### ModelsExpand Collapse

MaintenanceConfigGetResponse object {maintenance\_config } Contains table maintenance configuration.

maintenance\_config: object {compaction, interval, snapshot\_expiration } Configures maintenance for the table.

compaction: optional object {state, target\_size\_mb, next\_eligible\_at } Configures compaction settings for table optimization.

state: "enabled"or "disabled" Specifies the state of maintenance operations.

One of the following: "enabled" Link to this property "disabled" Link to this property

Link to this property

target\_size\_mb: "64"or "128"or "256"or "512" Sets the target file size for compaction in megabytes. Defaults to “128”.

One of the following: "64" Link to this property "128" Link to this property "256" Link to this property "512" Link to this property

Link to this property next\_eligible\_at: optional string Earliest time when the scheduler can claim this operation. Null when disabled. formatdate-time Link to this property

Link to this property interval: optional string Scheduling interval between normal table maintenance runs. Link to this property

snapshot\_expiration: optional object {max\_snapshot\_age, min\_snapshots\_to\_keep, state, next\_eligible\_at }

max\_snapshot\_age: string Specifies the maximum age for snapshots. Link to this property min\_snapshots\_to\_keep: number Specifies the minimum number of snapshots to retain. Defaults to 100. formatint64 minimum1 Link to this property

state: "enabled"or "disabled" Specifies the state of maintenance operations.

One of the following: "enabled" Link to this property "disabled" Link to this property

Link to this property next\_eligible\_at: optional string Earliest time when the scheduler can claim this operation. Null when disabled. formatdate-time Link to this property

Link to this property

[Link to this property](<#(resource)%20basin_catalog.namespaces.tables.maintenance_configs%20%3E%20(model)%20maintenance_config_get_response%20%3E%20(schema)>)

MaintenanceConfigUpdateResponse object {compaction, interval, snapshot\_expiration } Configures maintenance for the table.

compaction: optional object {state, target\_size\_mb, next\_eligible\_at } Configures compaction settings for table optimization.

state: "enabled"or "disabled" Specifies the state of maintenance operations.

One of the following: "enabled" Link to this property "disabled" Link to this property

Link to this property

target\_size\_mb: "64"or "128"or "256"or "512" Sets the target file size for compaction in megabytes. Defaults to “128”.

One of the following: "64" Link to this property "128" Link to this property "256" Link to this property "512" Link to this property

Link to this property next\_eligible\_at: optional string Earliest time when the scheduler can claim this operation. Null when disabled. formatdate-time Link to this property

Link to this property interval: optional string Scheduling interval between normal table maintenance runs. Link to this property

snapshot\_expiration: optional object {max\_snapshot\_age, min\_snapshots\_to\_keep, state, next\_eligible\_at }

state: "enabled"or "disabled" Specifies the state of maintenance operations.

One of the following: "enabled" Link to this property "disabled" Link to this property

Link to this property next\_eligible\_at: optional string Earliest time when the scheduler can claim this operation. Null when disabled. formatdate-time Link to this property

Link to this property

[Link to this property](<#(resource)%20basin_catalog.namespaces.tables.maintenance_configs%20%3E%20(model)%20maintenance_config_update_response%20%3E%20(schema)>)