org create

The org create command creates a new organization in your Stacktape account and returns a new API key scoped to it. Organizations are the account boundary Stacktape uses for projects, connected AWS accounts, and user access. Use org create when you need a separate organization and API key for a team or workspace.

Usage

Run org create to create a new organization and receive an API key scoped to it.

stacktape org create

In interactive mode, Stacktape prompts you for the organization name. To skip the prompt, pass the organization name as an argument (org create <organization-name>).

stacktape org create my-team

For programmatic or AI-agent usage, pass --agent to disable interactive prompts. In agent mode, the organization name is required — the command exits with an error if it is missing.

stacktape org create my-team --agent

You must be logged in before running this command. Use stacktape login to configure your API key.

What the command returns

On success, org create outputs three pieces of information:

  • Organization name — the name you provided.
  • Organization ID — a unique identifier assigned by Stacktape.
  • Organization API key — a new API key scoped to the created organization. Use this key with stacktape login to switch your CLI context to the new organization.

In agent mode, Stacktape does not prompt for the organization name, so the organization name argument is required. Use --json if you need machine-readable NDJSON output.

Flags reference

All flags accepted by org create are listed below. None are required in interactive mode.

stacktape org create <organization-name>CLI options
-h, --helpstring

Show Help

If provided, the command will not execute and will instead print help information.

--log-level"info" | "debug" | "error"

Log Level

The level of logs to print to the console.

  • info: Basic information about the operation.
  • error: Only errors.
  • debug: Detailed information for debugging.
--organization-name (positional 1)string

Organization Name

The name of the Stacktape organization.

--quietboolean

Quiet

Hide progress, banners, success messages and hints. Command output, warnings and errors are still printed.

Examples

Increase log verbosity for troubleshooting:

stacktape org create production-team --debug

Commands commonly used alongside org create:

  • org list — list all organizations accessible with your current user.
  • org delete — delete the organization of your API key.
  • login — configure your API key, including switching to the new organization's key.