> ## Documentation Index
> Fetch the complete documentation index at: https://developer.watson-orchestrate.ibm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing knowledge bases

Manage the knowledge bases in your active environment.

## Getting knowledge base status

To get the status of an existing knowledge base, run the following command. For built-in knowledge bases, this will include a `Ready` property, which denotes whether your index has been successfully created and the knowledge base is ready to use:

```bash BASH theme={null}
orchestrate knowledge-bases status --name my-base-name
```

## Updating knowledge base

To update a knowledge base, run the import command again using the same knowledge base name as the knowledge base you want to update.

```bash BASH theme={null}
orchestrate knowledge-bases import -f <path to knowledge base file that you want to update>
```

## Removing knowledge base

To remove an existing knowledge base, run the following command:

```bash BASH theme={null}
orchestrate knowledge-bases remove --name my-base-name
```

## Listing knowledge bases

To list all knowledge bases, run the following command:

```bash BASH theme={null}
orchestrate knowledge-bases list
```

## Exporting knowledge bases

Use the `orchestrate knowledge-bases export` command to export a knowledge base specification file YAML configuration from your active environment.

```bash BASH theme={null}
orchestrate knowledge-bases export -n <knowledge-base-name> -o <output-path>.yaml
```

<Expandable title="command flags">
  <ResponseField name="--name / -n" type="string">
    The name of the knowledge base you want to export.
  </ResponseField>

  <ResponseField name="--id / -i" type="string">
    The ID of the knowledge base you want to export.
  </ResponseField>

  <ResponseField name="--output / -o" type="string">
    The path where the exported knowledge base specification file will be saved. The extension should be a YAML file.
  </ResponseField>
</Expandable>

<Note>
  **Note:**

  Documents cannot be exported as they are not stored in a non-indexed state by the watsonx Orchestrate platform.
</Note>