Temporal

Namespace Commands

Create and configure namespaces for multi-tenancy, isolation, and environment separation. Namespaces provide logical boundaries for workflows.

8 commands

Pro Tips

Use separate namespaces for dev, staging, and production environments.

Set --retention to control how long closed workflow history is kept (default 72h).

Enable --global flag for multi-region namespaces in cluster setups.

Common Mistakes

Namespace deletion is permanent and removes all workflow history. Use with extreme caution.

Commands

Create namespace

$ temporal operator namespace create --namespace production

Create a new namespace.

Create with retention

$ temporal operator namespace create --namespace prod --retention 168h

Create namespace with custom retention (7 days).

Create global namespace

$ temporal operator namespace create --namespace global-ns --global

Create multi-region namespace for cluster replication.

List namespaces

$ temporal operator namespace list

Display all namespaces on the server.

Describe namespace

$ temporal operator namespace describe --namespace production

Show detailed namespace configuration.

Update namespace retention

$ temporal operator namespace update --namespace prod --retention 336h

Update retention period to 14 days.

Enable archival

$ temporal operator namespace update --namespace prod --history-archival-state enabled

Enable history archival for long-term storage.

Delete namespace

$ temporal operator namespace delete --namespace old-ns --yes

Permanently delete namespace and all workflow history.