Members

Manage organization members, roles, and access control

Early Access - The Dcycle CLI is currently available for enterprise customers. Contact us to learn more about access.

Overview

The member command manages user access within your active organization. You can list current members, invite new users, change roles, and remove access — all from the terminal.

Members can also be managed via dcy org invite, which is an alias for the same invitation flow.

Roles

Role	Aliases	Description
admin	administrator	Full access — manage members, settings, and all data
member	—	Standard access — view and manage emissions data
fund	—	Limited access — view-only for investment portfolio tracking

---

List Members

dcy member list

Output:

Showing 4 members in Acme Corp
550e8400-... | Jane Doe      | [e-mail]  | admin  | active
661f9511-... | John Smith    | [e-mail]  | member | active
772a0622-... | Alice Brown   | [e-mail] | member | active
883b1733-... | N/A           | [e-mail]   | fund   | pending

Members without a first/last name show N/A.

Flag	Short	Default	Description
--status	—	—	Filter by status (e.g. active, pending)
--sort-by	-s	—	Sort by: name, email, role, status
--sort-order	-o	asc	Sort order: asc or desc
--org	—	—	Organization ID override

# Filter by status
dcy member list --status active

# Sort by role
dcy member list --sort-by role

# Sort by name descending
dcy member list -s name -o desc

# JSON output for scripting
dcy member list --format json

JSON Response

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "first_name": "Jane",
    "last_name": "Doe",
    "email": "[e-mail]",
    "role": "admin",
    "status": "active",
    "created_at": "2024-01-15T10:30:00Z"
  }
]

---

Show Member Details

dcy member show <member-id>

Output:

ID: 550e8400-e29b-41d4-a716-446655440000
Name: Jane Doe
Email: [e-mail]
Role: admin
Status: active
Created: 2024-01-15

Flag	Description
--org	Organization ID override

The member ID is a UUID. Use dcy member list --format json to find member IDs programmatically.

---

Invite Member

Send an invitation to add a new user to the organization:

dcy member invite [e-mail]

Output:

ID: 994c2844-e29b-41d4-a716-446655440000
Name: N/A
Email: [e-mail]
Role: member
Status: pending
Created: 2024-03-15

Flag	Short	Default	Description
--role	-r	member	Role to assign: admin, member, or fund
--send-email	—	true	Send invitation email
--lang	—	en	Email language
--org	—	—	Organization ID override

# Invite as admin
dcy member invite [e-mail] --role admin

# Invite without sending email (manual onboarding)
dcy member invite [e-mail] --send-email=false

# Invite in Spanish
dcy member invite [e-mail] --lang es

# Invite to a subsidiary without switching context
dcy member invite [e-mail] --org a1b2c3d4-...

# Capture the member ID from JSON output
MEMBER_ID=$(dcy member invite [e-mail] --format json | jq -r '.id')
echo "Invited member: $MEMBER_ID"

---

Edit Member Role

Change a member’s role:

dcy member edit <member-id> --role admin

Output:

ID: 550e8400-e29b-41d4-a716-446655440000
Name: Jane Doe
Email: [e-mail]
Role: admin
Status: active
Created: 2024-01-15

Flag	Short	Description
--role	-r	New role: admin, member, or fund (required)
--org	—	Organization ID override

# Promote to admin
dcy member edit 550e8400-... --role admin

# Downgrade to fund (view-only)
dcy member edit 550e8400-... -r fund

You must provide --role — there are no other editable fields. The command returns an error if no role is specified.

---

Delete Member

Remove a member from the organization:

# Interactive confirmation
dcy member delete <member-id>

Confirmation prompt:

Remove member [e-mail] (550e8400-...)? [y/N]

Output after confirmation:

member removed successfully: [e-mail]

Flag	Short	Default	Description
--yes	-y	false	Skip confirmation prompt
--org	—	—	Organization ID override

# Skip confirmation
dcy member delete 550e8400-... --yes

# Delete from a subsidiary
dcy member delete 550e8400-... --org a1b2c3d4-... --yes

---

Typical Workflows

Batch Onboard New Team Members

#!/bin/bash
# Invite a list of employees with a default role

ROLE="member"
LANG="en"
EMAILS=(
  [e-mail]
  [e-mail]
  [e-mail]
  [e-mail]
)

for email in "${EMAILS[@]}"; do
  echo "Inviting $email as $ROLE..."
  dcy member invite "$email" --role "$ROLE" --lang "$LANG"
done

# Verify invitations
echo ""
echo "Pending invitations:"
dcy member list --status pending

Audit Organization Access

# Export all members as JSON
dcy member list --format json > members.json

# List admins
dcy member list --format json | jq -r '.[] | select(.role == "admin") | .email'

# Count members by role
dcy member list --format json | \
  jq 'group_by(.role) | map({role: .[0].role, count: length})'

# Count by status
dcy member list --format json | \
  jq 'group_by(.status) | map({status: .[0].status, count: length})'

# Find pending invitations older than 30 days
dcy member list --status pending --format json | \
  jq '.[] | select(.created_at < "2024-06-01") | {email, created_at}'

Cross-Organization Member Management

Use --org to manage members in a different organization without switching context:

# List members in a subsidiary
dcy member list --org <subsidiary-org-id>

# Invite to a subsidiary
dcy member invite [e-mail] --org <subsidiary-org-id> --role member

# Invite the same user across multiple organizations
for org_id in $(dcy org list --format json | jq -r '.[].id'); do
  dcy member invite [e-mail] --org "$org_id" --role admin
done

Bulk Remove Inactive Members

#!/bin/bash
# Remove all pending members that haven't accepted

PENDING=$(dcy member list --status pending --format json | jq -r '.[].id')

if [ -z "$PENDING" ]; then
  echo "No pending members to remove"
  exit 0
fi

COUNT=$(echo "$PENDING" | wc -w)
echo "Removing $COUNT pending member(s)..."

for id in $PENDING; do
  dcy member delete "$id" --yes
done

echo "Done"

Compare Members Across Organizations

#!/bin/bash
# Find users who are members of multiple organizations

ORGS=$(dcy org list --format json | jq -r '.[].id')
ALL_EMAILS=$(mktemp)

for org_id in $ORGS; do
  dcy member list --org "$org_id" --format json | \
    jq -r '.[].email' >> "$ALL_EMAILS"
done

echo "Users in multiple organizations:"
sort "$ALL_EMAILS" | uniq -d
rm "$ALL_EMAILS"

---

Aliases

The list subcommand supports ls as a short alias:

dcy member ls          # same as dcy member list
dcy member ls -s role  # same as dcy member list --sort-by role

Next Steps

Organizations

Manage organization settings and hierarchy

Authentication

Configure authentication and API keys

Facilities

Manage physical locations and their emissions

Examples

Complete workflow examples

MCP Tools

Query members from AI assistants via MCP