Groups

global → group → device

# groups.yaml
- name: finance
  description: "Finance team devices"
  members:
    - alice@yourcompany.com
    - bob@yourcompany.com

- name: engineering
  description: "Engineering team"
  members:
    - eng-lead@yourcompany.com
    - device_id: a1b2c3d4-e5f6-...   # target a specific device UUID

agent-charley-cli apply --file policies/ --groups groups.yaml

# List all groups
agent-charley-cli groups list

# Create a group
agent-charley-cli groups create finance --description "Finance team devices"

# Add members
agent-charley-cli groups add-members finance \
  --email alice@company.com \
  --email bob@company.com \
  --device-id a1b2c3d4-e5f6-...

# Replace the full member list
agent-charley-cli groups set-members finance \
  --email alice@company.com

# Remove specific members
agent-charley-cli groups remove-members finance --email bob@company.com

# List device UUIDs in a group
agent-charley-cli groups list-devices finance

# List members with user details (email, name, machine ID, status)
agent-charley-cli groups list-members finance

# Delete a group
agent-charley-cli groups delete finance --yes

from charley_policy import CharleyClient

with CharleyClient() as client:
    # Create
    group = client.groups.create("finance", description="Finance team")

    # Add members by email or device UUID
    client.groups.add_members("finance",
        emails=["alice@company.com"],
        device_ids=["a1b2c3d4-e5f6-..."],
    )

    # Replace full member list
    client.groups.set_members("finance", emails=["alice@company.com"])

    # Remove members
    client.groups.remove_members("finance", emails=["bob@company.com"])

    # List device UUIDs in the group
    device_ids = client.groups.list_devices("finance")

    # List members with user details (email, name, machine ID, status)
    members = client.groups.list_members("finance")
    for m in members:
        print(m["enrolled_email"], m["device_id"], m["status"])

    # Rename or update description
    client.groups.update("finance", description="Finance & treasury")

    # Delete
    client.groups.delete("finance")

agent-charley-cli groups delete finance --yes

agent-charley-cli effective <device_id>

curl https://dash.charlemagnelabs.ai/api/devices \
  -H "x-api-key: ck_live_..."