bird organization members update

Usage

Code example

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

Code example

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

# the body it prints:

Code example

{
  "org_role": "billing_admin"
}

Code 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

Name	Description
bird organization members delete	Delete a member from the organization
bird organization members get	Get an organization member
bird organization members list	List organization members

Related resources

Continue with the documentation, guides and examples for this topic. Resources are in English.

Understand the conceptShould I use an API key or an OAuth token, and how do I rotate one?Implementation guideAuthentication & API keys

Get an implementation brief