---
title: "PUT /namespaces/{tableBucketARN}"
method: PUT
path: "/namespaces/{tableBucketARN}"
---

# PUT /namespaces/{tableBucketARN}

`PUT /namespaces/{tableBucketARN}`

Creates a namespace. A namespace is a logical grouping of tables within your table bucket, which you can use to organize tables. For more information, see [Create a namespace](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-namespace-create.html) in the _Amazon Simple Storage Service User Guide_.

Permissions

You must have the `s3tables:CreateNamespace` permission to use this operation.

## Path parameters

- `tableBucketARN` string, required

## Request body

- object
  - `namespace` NamespaceName[], required — A name for the namespace.

## Response `200`

Success

- CreateNamespaceResponse
  - `tableBucketARN` string, required — The Amazon Resource Name (ARN) of the table bucket the namespace was created in.
  - `namespace` NamespaceName[], required — The name of the namespace.

## Other responses

- `480` — InternalServerErrorException
- `481` — ForbiddenException
- `482` — NotFoundException
- `483` — TooManyRequestsException
- `484` — ConflictException
- `485` — BadRequestException

---

[API](https://skmtc.net/aws/apis/s3tables.md) · [All operations](https://skmtc.net/aws/apis/s3tables/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/s3tables/revisions/d7413f19d46e/schema)