Skip to main content
The organizations command group helps you manage your Pipecat Cloud organizations and API keys. You can list and select organizations, as well as create, list, and manage API keys for use with the platform.
Organization and user management is not available via the CLI. Please use the Pipecat Cloud Dashboard to manage organizations and users.

​
list

Lists all organizations that your account has access to, highlighting the currently active one used for CLI operations. Usage: 
pipecat cloud organizations list

​
select

Changes your active organization for CLI operations. This command either presents an interactive selection menu or directly sets a specified organization as your default. The selection is stored in your local configuration file (defaults to ~/.config/pipecatcloud/pipecatcloud.toml) and used for all subsequent CLI commands. Usage: 
pipecat cloud organizations select [OPTIONS]
Options:
​
--organization / -o
string
Bypass prompt by directly specifying a namespace / organization string.

​
keys

The keys sub-commands manage API keys for authenticating with Pipecat Cloud services.

​
keys list

Lists all API keys for the current organization. Usage: 
pipecat cloud organizations keys list [OPTIONS]
Options:
​
--organization / -o
string
Organization ID to list keys for. If not provided, the default organization will be used.

​
keys create

Create a new public API key for account / organization. Command will prompt the user to enter a human-readable name for the key. Usage: 
pipecat cloud organizations keys create [OPTIONS]
Options:
​
--organization / -o
string
Organization ID to create key for. If not provided, the default organization will be used.

​
keys delete

Delete an API key from your organization. Command will prompt the user to select which key they wish to delete. Usage: 
pipecat cloud organizations keys delete [OPTIONS]
Options:
​
--organization / -o
string
Organization ID to delete key for. If not provided, the default organization will be used.

​
keys use

Sets a specific API key as your default for CLI operations. The selected key is stored in the local configuration file (defaults to ~/.config/pipecatcloud/pipecatcloud.toml) and will be used for all subsequent requests to the Pipecat Cloud API. Please note that the key must be associated with the same user account or organization as you are making requests to. If the public key is revoked or deleted via the dashboard, the user will need to re-run this command to select a new key. Usage: 
pipecat cloud organizations keys use [OPTIONS]
Options:
​
--organization / -o
string
Organization ID to select default key from. If not provided, the default organization will be used.

​
properties

The properties sub-commands manage organization properties such as default region settings.

​
properties list

Lists all current property values for your organization. Usage: 
pipecat cloud organizations properties list [OPTIONS]
Options:
​
--organization / -o
string
Organization ID to list properties for. If not provided, the default organization will be used.

​
properties schema

Shows available properties with detailed metadata including type information, current values, default values, and available values. Usage: 
pipecat cloud organizations properties schema [OPTIONS]
Options:
​
--organization / -o
string
Organization ID to show properties schema for. If not provided, the default organization will be used.

​
properties set

Updates a specific organization property. Usage: 
pipecat cloud organizations properties set PROPERTY_NAME VALUE [OPTIONS]
Arguments:
​
PROPERTY_NAME
string
required
Name of the property to set (e.g., defaultRegion)
​
VALUE
string
required
Value to set for the property
Options:
​
--organization / -o
string
Organization ID to update property for. If not provided, the default organization will be used.
Example: 
pipecat cloud organizations properties set defaultRegion eu-central

​
default-region

Convenience command to get or set the default region for your organization. Usage: 
pipecat cloud organizations default-region [REGION] [OPTIONS]
Arguments:
​
REGION
string
Region to set as default. If omitted, displays the current default region and available regions.
Options:
​
--organization / -o
string
Organization ID to configure. If not provided, the default organization will be used.
Examples: View current default region: 
pipecat cloud organizations default-region
Set default region: 
pipecat cloud organizations default-region eu-central

More about organizations

Managing your account and collaborating on agents as part of a team