> For the complete documentation index, see [llms.txt](https://organizations.takomo.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://organizations.takomo.io/command-line-usage/account-stacks/list-accounts-stacks.md).

# List accounts stacks

List stacks from accounts.

## Usage

```bash
tkm org accounts list-stacks [ou-path...] \
  --config-set-type <config-set-type> \
  [--account <account_id>]... \
  [--concurrent-accounts <number>] \
  [--config-set <config-set>] \
  [--command-path <command-path>]
```

## Positional arguments

* `ou-path...`
  * You can pass one or more organizational unit paths to list stacks only from the accounts that belong to the organizational units located under the given paths in the organization hierarchy.

## Options

In addition to the [common options](https://docs.takomo.io/command-line-usage/common-options), this command has the following options.

* `--config-set-type <config-set-type>`
  * List stacks that belong to a config sets of this type.
  * The provided config set type must be either **standard** or **bootstrap**.&#x20;
* `--account <account-id> | -a <account-id>`
  * Choose accounts to from where to list stacks. You can use this option multiple times to specify more accounts.
* `--concurrent-accounts <number>`
  * Number of accounts to process concurrently.
* `--config-set <config-set>`
  * List only stacks that belong to this config set.
  * Optional.
* `--command-path <command-path>`
  * List only stacks under this command path in the config set specified with the `--config-set` option.
  * Optional.
  * To use this option, also the `--config-set` option must be given.

## IAM permissions

These are the minimum IAM permissions required to run this command.

```yaml
Statement:

  # IAM permissions required for the organization master account.
  - Action:
      - organizations:DescribeOrganization
      - organizations:DescribePolicy
      - organizations:ListAWSServiceAccessForOrganization
      - organizations:ListAccounts
      - organizations:ListAccountsForParent
      - organizations:ListOrganizationalUnitsForParent
      - organizations:ListPolicies
      - organizations:ListRoots
      - organizations:ListTargetsForPolicy
    Effect: Allow
    Resource: '*'
    Sid: organizations
  - Action:
      - sts:AssumeRole
    Effect: Allow
    Resource: '*'
    Sid: sts
    
  # IAM permissions required in each organization account.
  - Sid: IAM
    Effect: Allow
    Action:
      - sts:AssumeRole
      - cloudformation:ListStacks
    Resource: "*"  
```

## Examples

List stacks from every account.

```bash
tkm org accounts list-stacks --config-set-type standard
```

List stacks from accounts that belong to the Root/Workload organizational unit.

```bash
tkm org accounts list-stacks ROOT/Workload --config-set-type standard
```

List all stacks from accounts 123456789012 and 210987654321

```bash
tkm org accounts list-stacks \
  -a 123456789012 210987654321 \
  --config-set-type standard
```

List stacks from every account that belong to bootstrap config sets.

```bash
tkm org accounts list-stacks --config-set-type bootstrap
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://organizations.takomo.io/command-line-usage/account-stacks/list-accounts-stacks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
