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.
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>).
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.
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 loginto 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, --helpstringShow 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)stringOrganization Name
The name of the Stacktape organization.
--quietbooleanQuiet
Hide progress, banners, success messages and hints. Command output, warnings and errors are still printed.
Examples
Increase log verbosity for troubleshooting:
Related commands
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.