> For the complete MongoDB documentation index, see www.mongodb.com/docs/llms.txt

# atlas teams rename

Rename a team in your organization.

To use this command, you must authenticate with a user account, a service account, or an API key with the Organization Owner role.

## Syntax

```text
atlas teams rename <newName> [options]
```

## Arguments

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| newName | string | true | New label that identifies the team. |

## Options

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| -h, --help |  | false | help for rename |
| --orgId | string | false | Organization ID to use. This option overrides the settings in the configuration file or environment variable. |
| -o, --output | string | false | Output format. Valid values are json, json-path, go-template, or go-template-file. To see the full output, use the -o json option. |
| --teamId | string | true | Unique 24-digit string that identifies the team. |

## Inherited Options

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| -P, --profile | string | false | Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see [https://dochub.mongodb.org/core/atlas-cli-save-connection-settings.](https://dochub.mongodb.org/core/atlas-cli-save-connection-settings) |

## Output

If the command succeeds, the CLI returns output similar to the following sample. Values in brackets represent your values.

```text
Team '<Name>' updated.
```

## Examples

```text
# Rename a team in the organization with ID 5e2211c17a3e5a48f5497de3:
atlas teams rename newName --teamId 5e1234c17a3e5a48f5497de3 --orgId 5e1234c17a3e5a48f5497de3 --output json
```