`modal workspace`

Interact with the current Modal Workspace.

A Workspace is the top-level account that owns your Modal resources. Use these commands to manage workspace-level settings such as proxy tokens.

Usage:

modal workspace [OPTIONS] COMMAND [ARGS]...

Options:

--help: Show this message and exit.

Commands:

members: View the members of the current Workspace.
proxy-tokens: Manage the proxy tokens of the current Workspace.

View the members of the current Workspace.

Usage:

modal workspace members [OPTIONS] COMMAND [ARGS]...

Options:

--help: Show this message and exit.

Commands:

list: List the members of the current Workspace.

List the members of the current Workspace.

Usage:

modal workspace members list [OPTIONS]

Options:

--json
--help: Show this message and exit.

Manage the proxy tokens of the current Workspace.

Proxy tokens provide authentication to HTTP interfaces on Modal Servers and Web Functions. They are passed as request headers (Modal-Key and Modal-Secret). See https://modal.com/docs/guide/webhook-proxy-auth for more information.

Proxy tokens and secrets have wk- and ws- prefixes, respectively. The cannot be interchanged with API tokens (which use ak- and as- prefixes).

On workspaces with RBAC enabled, tokens are scoped to specific environments; use the allow and revoke commands to manage environment associations.

Usage:

modal workspace proxy-tokens [OPTIONS] COMMAND [ARGS]...

Options:

--help: Show this message and exit.

Commands:

allow: Allow a proxy token to authenticate to an environment.
create: Create a proxy token in the current Workspace.
delete: Delete a proxy token from the current Workspace.
list: List the proxy tokens of the current Workspace.
revoke: Revoke a proxy token’s access to an environment.

Allow a proxy token to authenticate to an environment.

Usage:

modal workspace proxy-tokens allow [OPTIONS] TOKEN_ID ENVIRONMENT_NAME

Options:

--help: Show this message and exit.

Create a proxy token in the current Workspace.

Usage:

modal workspace proxy-tokens create [OPTIONS]

Options:

--json
--help: Show this message and exit.

Delete a proxy token from the current Workspace.

Usage:

modal workspace proxy-tokens delete [OPTIONS] TOKEN_ID

Options:

-y, --yes: Run without pausing for confirmation.
--help: Show this message and exit.

List the proxy tokens of the current Workspace.

Usage:

modal workspace proxy-tokens list [OPTIONS]

Options:

-e, --environment TEXT: Only list tokens associated with this environment. Lists all tokens when omitted.
--json
--help: Show this message and exit.

Revoke a proxy token’s access to an environment.

Usage:

modal workspace proxy-tokens revoke [OPTIONS] TOKEN_ID ENVIRONMENT_NAME

Options:

--help: Show this message and exit.