> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tensormesh.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# tm admin users change-role

> Change a user's role (POST /v1/admin/users/change_role).

## Usage

```sh theme={null}
tm admin users change-role [OPTIONS]
```

## Options

| Name                 | Type                       | Required          | Default                     | Details                                                                                          |   |                        |
| -------------------- | -------------------------- | ----------------- | --------------------------- | ------------------------------------------------------------------------------------------------ | - | ---------------------- |
| `--target-user-id`   | `text`                     | no                |                             | Target user id.                                                                                  |   |                        |
| `--target-user-role` | \`choice\[USER\_ROLE\_USER | USER\_ROLE\_ADMIN | USER\_ROLE\_SUPER\_ADMIN]\` | no                                                                                               |   | Target user role enum. |
| `--user-id`          | `text`                     | no                |                             | Admin user id for authorization (optional).                                                      |   |                        |
| `--yes`              | `boolean`                  | no                | `false`                     | Skip confirmation prompt. Boolean flag.                                                          |   |                        |
| `--json`             | `text`                     | no                |                             | JSON request body or @file.json (overrides flags). When omitted, reads piped stdin if available. |   |                        |
| `--file`             | `path`                     | no                |                             | Read JSON request body from file (overrides flags).                                              |   |                        |
| `--timeout`          | `float`                    | no                |                             | HTTP timeout in seconds.                                                                         |   |                        |

## Inherited Global Options

| Name                  | Type           | Required | Default                              | Details                                                                                                                      |          |    |          |                                                                   |
| --------------------- | -------------- | -------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------- | -------- | -- | -------- | ----------------------------------------------------------------- |
| `--version`, `-V`     | `boolean`      | no       | `false`                              | Show the version and exit. Boolean flag.                                                                                     |          |    |          |                                                                   |
| `--config`            | `path`         | no       | `"~/.config/tensormesh/config.toml"` | Path to config TOML file                                                                                                     |          |    |          |                                                                   |
| `--output`            | \`choice\[text | json     | yaml                                 | raw                                                                                                                          | table]\` | no | `"text"` | Output format (text is human-readable; json is machine-friendly). |
| `--quiet`             | `boolean`      | no       | `false`                              | Suppress non-essential output. Boolean flag.                                                                                 |          |    |          |                                                                   |
| `--debug`             | `boolean`      | no       | `false`                              | Print debug logs to stderr (secrets redacted). Boolean flag.                                                                 |          |    |          |                                                                   |
| `--ca-bundle`         | `path`         | no       |                                      | Path to a PEM CA bundle for TLS verification (overrides TENSORMESH\_CA\_BUNDLE).                                             |          |    |          |                                                                   |
| `--max-retries`       | `integer`      | no       |                                      | Max retries for idempotent HTTP requests on transient errors (overrides TENSORMESH\_MAX\_RETRIES; subcommands may override). |          |    |          |                                                                   |
| `--controlplane-base` | `text`         | no       |                                      | Override the Control Plane base URL.                                                                                         |          |    |          |                                                                   |

## Parent Command

* [`tm admin users`](/cli/reference/admin/users)