Members

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      | jane@company.com  | admin  | active
661f9511-... | John Smith    | john@company.com  | member | active
772a0622-... | Alice Brown   | alice@company.com | member | active
883b1733-... | N/A           | bob@company.com   | 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": "jane@company.com",
    "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: jane@company.com
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 user@example.com

Output:

ID: 994c2844-e29b-41d4-a716-446655440000
Name: N/A
Email: user@example.com
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 admin@company.com --role admin

# Invite without sending email (manual onboarding)
dcy member invite user@company.com --send-email=false

# Invite in Spanish
dcy member invite user@company.com --lang es

# Invite to a subsidiary without switching context
dcy member invite user@company.com --org a1b2c3d4-...

# Capture the member ID from JSON output
MEMBER_ID=$(dcy member invite user@company.com --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: jane@company.com
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 jane@company.com (550e8400-...)? [y/N]

Output after confirmation:

member removed successfully: jane@company.com

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=(
  alice@company.com
  bob@company.com
  carol@company.com
  dave@company.com
)

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 user@company.com --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 shared-admin@company.com --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

Getting Started

Commands

Examples

Overview

Roles

List Members

JSON Response

Show Member Details

Invite Member

Edit Member Role

Delete Member

Typical Workflows

Batch Onboard New Team Members

Audit Organization Access

Cross-Organization Member Management

Bulk Remove Inactive Members

Compare Members Across Organizations

Aliases

Next Steps

Organizations

Authentication

Facilities

Examples

MCP Tools

​Overview

​Roles

​List Members

​JSON Response

​Show Member Details

​Invite Member

​Edit Member Role

​Delete Member

​Typical Workflows

​Batch Onboard New Team Members

​Audit Organization Access

​Cross-Organization Member Management

​Bulk Remove Inactive Members

​Compare Members Across Organizations

​Aliases

​Next Steps

Organizations

Authentication

Facilities

Examples

MCP Tools

Overview

Roles

List Members

JSON Response

Show Member Details

Invite Member

Edit Member Role

Delete Member

Typical Workflows

Batch Onboard New Team Members

Audit Organization Access

Cross-Organization Member Management

Bulk Remove Inactive Members

Compare Members Across Organizations

Aliases

Next Steps