Skip to main content
Manage organization members and roles.

​
members list

List all members of the current organization. 
floo orgs members list

Members:
  User ID                               Email                Role
  a1b2c3d4-...                          alice@example.com    admin
  e5f6g7h8-...                          bob@example.com      member
  i9j0k1l2-...                          carol@example.com    viewer

​
JSON output

{
  "success": true,
  "data": {
    "members": [
      {
        "user_id": "a1b2c3d4-...",
        "email": "alice@example.com",
        "role": "admin"
      },
      {
        "user_id": "e5f6g7h8-...",
        "email": "bob@example.com",
        "role": "member"
      }
    ]
  }
}

​
members set-role

Change a member’s role. 
floo orgs members set-role a1b2c3d4 member

​
Arguments

ArgumentDescription
USER_IDUser ID of the member
ROLENew role: admin, member, or viewer

​
Examples

# Promote to admin
floo orgs members set-role a1b2c3d4 admin

# Downgrade to viewer
floo orgs members set-role a1b2c3d4 viewer

# Agent workflow: set role and confirm
floo orgs members set-role a1b2c3d4 member --json 2>/dev/null | jq -r '.data.role'

​
JSON output

{
  "success": true,
  "data": {
    "user_id": "a1b2c3d4-...",
    "role": "member"
  }
}

​
switch

Switch the default org for subsequent commands. Useful when you belong to more than one org — the chosen org is used to resolve --app and org-scoped commands until you switch again. 
floo orgs switch acme

​
Arguments

ArgumentDescription
ORG_SLUGOrg slug or ID to make active

​
Errors

CodeMeaning
NOT_AUTHENTICATEDRun floo auth login first
INVALID_ROLERole must be admin, member, or viewer