Documentation
Teams

Member Management

Invite team members, manage roles, and control access to your organization.

Inviting Members

Organization Owners and Admins can invite new members. Members receive an email invitation and must accept it to join the organization.

1

Go to Team Settings

Navigate to Settings → Team → Members in your ARKA-AI dashboard.

2

Click Invite Member

Click the "Invite Member" button. Enter the person's email address and select their initial role (Member, Viewer, or Admin).

3

Member Accepts Invitation

The invited person receives an email with a link to join. Once they accept, they'll be added to your organization with the assigned role.

Seat Availability

You can only invite members if you have available seats. If you're at capacity, you'll need to add more seats before inviting new members.

Pending Invitations

Invitations that haven't been accepted yet appear in the "Pending Invites" section. You can:

  • Resend — Send another invitation email
  • Revoke — Cancel the invitation before it's accepted

Invitations expire after 7 days. If an invitation expires, you'll need to send a new one.

Changing Member Roles

Admins can change the roles of members below them in the hierarchy. The owner can change anyone's role.

Role Change Rules

  • • Admins can change Members to Viewers (and vice versa)
  • • Admins cannot promote someone to Admin or Owner
  • • Only the Owner can promote someone to Admin
  • • Only the Owner can transfer ownership to another member

Removing Members

Admins and Owners can remove members from the organization. When a member is removed:

  • They lose access to all team workspaces immediately
  • Their seat is freed up for a new member
  • They can still access their personal workspaces
  • If they had personal Pro before joining, they'll need to resubscribe

Cannot Remove Yourself

You cannot remove yourself from an organization. To leave, ask another admin to remove you, or if you're the owner, transfer ownership first.

Transferring Ownership

The organization owner can transfer ownership to another member. This is useful when the original owner leaves the company or changes roles.

1

Go to Organization Settings

Navigate to Settings → Team and find the "Transfer Ownership" option.

2

Select New Owner

Choose a current member to become the new owner. They must already be a member of the organization.

3

Confirm Transfer

Confirm the transfer. You'll be demoted to Admin and the selected member becomes the new Owner.

Irreversible Action

Ownership transfer cannot be undone by the previous owner. Make sure you select the correct person.

API Endpoints

For programmatic member management, use the following API endpoints:

Member Management APIshttp
# List members
GET /api/org/[orgId]/members

# Invite a member
POST /api/org/[orgId]/invites
Body: { "email": "user@example.com", "role": "member" }

# Update member role
PATCH /api/org/[orgId]/members/[userId]
Body: { "role": "admin" }

# Remove member
DELETE /api/org/[orgId]/members/[userId]

# List pending invites
GET /api/org/[orgId]/invites

# Revoke invite
DELETE /api/org/[orgId]/invites/[inviteId]