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

# orgs

> CLI reference: floo orgs — manage organization members, roles, and the active org

Manage organization members and roles.

## members list

List all members of the current organization.

```bash theme={null}
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

```json theme={null}
{
  "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.

```bash theme={null}
floo orgs members set-role a1b2c3d4 member
```

### Arguments

| Argument  | Description                              |
| --------- | ---------------------------------------- |
| `USER_ID` | User ID of the member                    |
| `ROLE`    | New role: `admin`, `member`, or `viewer` |

### Examples

```bash theme={null}
# 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

```json theme={null}
{
  "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.

```bash theme={null}
floo orgs switch acme
```

### Arguments

| Argument   | Description                   |
| ---------- | ----------------------------- |
| `ORG_SLUG` | Org slug or ID to make active |

***

## Errors

| Code                | Meaning                                     |
| ------------------- | ------------------------------------------- |
| `NOT_AUTHENTICATED` | Run `floo auth login` first                 |
| `INVALID_ROLE`      | Role must be `admin`, `member`, or `viewer` |