# REST Resource: iceberg.v1.restcatalog.v1.projects.catalogs.namespaces

- [Resource: IcebergNamespace](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/iceberg.v1.restcatalog.v1.projects.catalogs.namespaces#IcebergNamespace)
  - [JSON representation](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/iceberg.v1.restcatalog.v1.projects.catalogs.namespaces#IcebergNamespace.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/iceberg.v1.restcatalog.v1.projects.catalogs.namespaces#METHODS_SUMMARY)

## Resource: IcebergNamespace

The namespace object to create.

| JSON representation |
|---|
| ``` { "namespace": [ string ], "properties": { string: string, ... } } ``` |

| Fields ||
|---|---|
| `namespace[]` | `string` Required. The name of the namespace. |
| `properties` | `map (key: string, value: string)` Optional. The optional properties of the namespace. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/iceberg.v1.restcatalog.v1.projects.catalogs.namespaces/create` | Creates a namespace in the catalog. |
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/iceberg.v1.restcatalog.v1.projects.catalogs.namespaces/delete` | Returns 204, not 200 on success. |
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/iceberg.v1.restcatalog.v1.projects.catalogs.namespaces/get` | Gets an Iceberg namespace in the catalog (or checks if it exists, if the method is HEAD). |
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/iceberg.v1.restcatalog.v1.projects.catalogs.namespaces/list` | Lists Iceberg namespaces in the catalog. |
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/iceberg.v1.restcatalog.v1.projects.catalogs.namespaces/properties` | Updates namespace properties. |
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/iceberg.v1.restcatalog.v1.projects.catalogs.namespaces/register` | Register a table using given metadata file location. |
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/iceberg.v1.restcatalog.v1.projects.catalogs.namespaces/updateProperties` | Updates namespace properties. |