# `bird organization members update`

## Usage

```bash
bird organization members update <member-id> [flags]
```

## Description

Update an org member's org-level role.

Changes the member's organization role; workspace role grants are unaffected.
The member is identified by user ID.

Build the request from flags, a JSON OrganizationMemberUpdate body via --body-file ("-" reads
stdin), or both — a flag overrides the matching body field. Run --example to
print a ready-to-edit body, or --dry-run to print the resolved request without
sending it.

## Examples

```bash
# print the body shape (no credentials needed)
bird organization members update --example

# promote a member to owner
bird organization members update usr_123 --org-role owner

# remove the org role while keeping workspace grants
bird organization members update usr_123 --org-role ""
```

## Options

#### Role

| Name         | Description                                                                                                                               |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `--org-role` | Org-level role to set: billing_admin or owner. Pass an empty value (--org-role "") to remove the org role while keeping workspace grants. |

#### Request

| Name                | Description                                                  |
| ------------------- | ------------------------------------------------------------ |
| `--body-file`       | Read the JSON request body from this file; "-" reads stdin   |
| `--example`         | Print a complete example request body, then exit             |
| `--dry-run`         | Print the resolved request without sending it, then exit     |
| `--idempotency-key` | Deduplication key; a retry with the same key won't act twice |

#### Options

| Name                | Description                                      |
| ------------------- | ------------------------------------------------ |
| `--response-schema` | Print the fields this command returns, then exit |

## Related

| Name                                                                                  | Description                  |
| ------------------------------------------------------------------------------------- | ---------------------------- |
| [`bird organization members delete`](/docs/cli/reference/organization-members-delete) | Remove a member from the org |
| [`bird organization members get`](/docs/cli/reference/organization-members-get)       | Get an org member            |
| [`bird organization members list`](/docs/cli/reference/organization-members-list)     | List org members             |