The status command displays detailed information about a deployed stack, including its outputs (URLs, endpoints, resource identifiers) and the list of AWS resources in the stack. Use it after deploying to discover endpoints, verify resource creation, or feed stack data into scripts and CI pipelines.
Usage
Alternatively, pass the stack name directly.
The --region flag is the only required argument. You identify the target stack in one of two ways: provide --stack-name directly (formatted as projectName-stage), or provide both --project and --stage together. If neither combination is supplied, the command exits with an error: "Provide either --stack-name OR both --project and --stage".
With --agent, status skips the interactive stack-details view and uses the CLI's JSONL protocol. The final result event contains a versioned stacktape.info-stack.v1 document at data.result, including the resolved stack name, region, outputs, Stacktape resource map, and CloudFormation resources. Read the final result event rather than parsing informational log messages.
The --aws-account flag selects which connected AWS account to query. The account must first be connected in the Stacktape Console. Omit it when the default account selection is sufficient.
Command reference
stacktape statusCLI options-r, --regionrequired"us-east-2" | "us-east-1" | "us-west-1" | "us-west-2" | "ap-east-1" | "ap-south-1" | "ap-northeast-3" | "ap-northeast-2" | "ap-southeast-1" | "ap-southeast-2" | "ap-northeast-1" | "ca-central-1" | "eu-central-1" | "eu-west-1" | "eu-west-2" | "eu-west-3" | "eu-north-1" | "me-south-1" | "sa-east-1" | "af-south-1" | "eu-south-1"AWS Region
The AWS region for the operation. For a list of available regions, see the AWS documentation.
Inside a project whose config declares region, the flag is optional and overrides the config.
--aws-accountstringAWS Account
The name of the AWS account to use for the operation. The account must first be connected in the Stacktape Console.
Without it, the account is chosen by --profile, AWS_PROFILE or AWS credentials in environment variables, then by your saved default, then by your organization's only connected account. --aws-account takes precedence over all of them, but AWS credentials in environment variables must then belong to that account.
-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.
--projectstringProject Name
The name of the Stacktape project for this operation.
Commands that target a stack take it from projectName in the project's config when the flag is absent.
--quietbooleanQuiet
Hide progress, banners, success messages and hints. Command output, warnings and errors are still printed.
--stack-namestringStack Name
The name of the CloudFormation stack (format: projectName-stage).
-s, --stagestringStage
The stage for the operation (e.g., production, staging, dev-john). You can set a default stage using the defaults set command. Stage names use lowercase letters, numbers and dashes, with at least 2 characters. The project name, a dash and the stage form the CloudFormation stack name, which can have at most 128 characters. Stacktape shortens an AWS resource name that would be too long and adds a hash.
Examples
Inspect a production stack to retrieve its outputs (URLs, resource identifiers).
Use the combined stack name instead of separate project and stage flags.
Get versioned JSONL output for a CI pipeline, coding agent, or script.
The stable command document is nested in the final event:
Query a stack in a specific connected AWS account.
Related commands
stack list— List all stacks deployed in a region. Use this to discover stack names before drilling into one withstatus.stack history— View recent deployment operations and their success/failure status for a project or stage.deploy— Deploy or update a stack. After deploying, usestatusto retrieve the resulting outputs and endpoints.param get— Retrieve a single parameter value from a resource in a deployed stack, rather than the full stack overview.