Teams CLI reference

The teams command lets you manage teams and team memberships.

List teams

hb teams list --account-id 12345

Required flags:

• --account-id — Account ID

Optional flags:

• -o, --output — Output format: table or json (default: table)

Get team details

hb teams get --id 67890

Required flags:

• --id — Team ID

Optional flags:

• -o, --output — Output format: text or json (default: text)

Create a team

hb teams create --account-id 12345 --name "Backend Team"

Required flags:

• --account-id — Account ID
• --name — Team name

Optional flags:

• -o, --output — Output format: text or json (default: text)

Update a team

hb teams update --id 67890 --name "New Team Name"

Required flags:

• --id — Team ID
• --name — New team name

Optional flags:

• -o, --output — Output format: text or json (default: text)

Delete a team

hb teams delete --id 67890

Required flags:

• --id — Team ID

---

Managing team members

List members

hb teams members list --team-id 67890

Required flags:

• --team-id — Team ID

Optional flags:

• -o, --output — Output format: table or json (default: table)

Update member permissions

hb teams members update --team-id 67890 --member-id 11111 --admin true

Required flags:

• --team-id — Team ID
• --member-id — Member ID
• --admin — Set admin status (true or false)

Optional flags:

• -o, --output — Output format: text or json (default: text)

Remove a member

hb teams members remove --team-id 67890 --member-id 11111

Required flags:

• --team-id — Team ID
• --member-id — Member ID

---

Managing team invitations

List invitations

hb teams invitations list --team-id 67890

Required flags:

• --team-id — Team ID

Optional flags:

• -o, --output — Output format: table or json (default: table)

Get an invitation

hb teams invitations get --team-id 67890 --invitation-id 22222

Required flags:

• --team-id — Team ID
• --invitation-id — Invitation ID

Optional flags:

• -o, --output — Output format: text or json (default: text)

Create an invitation

hb teams invitations create --team-id 67890 --cli-input-json '{
  "email": "user@example.com",
  "admin": false,
  "message": "Welcome to the team!"
}'

Required flags:

• --team-id — Team ID
• --cli-input-json — JSON payload (inline string or file://path)

JSON fields:

• email — Email address to invite
• admin — Whether the user should be a team admin
• message — Optional welcome message

Optional flags:

• -o, --output — Output format: text or json (default: text)

Update an invitation

hb teams invitations update --team-id 67890 --invitation-id 22222 --cli-input-json '{"admin": true}'

Required flags:

• --team-id — Team ID
• --invitation-id — Invitation ID
• --cli-input-json — JSON payload with fields to update

Optional flags:

• -o, --output — Output format: text or json (default: text)

Delete an invitation

hb teams invitations delete --team-id 67890 --invitation-id 22222

Required flags:

• --team-id — Team ID
• --invitation-id — Invitation ID