Team Management

Manage team members, roles, and permissions within your organization.

Overview

The Organization page allows you to:

• View team members and their roles
• Invite new members (admins and owners)
• Manage member access and roles
• Track team usage statistics
• View audit logs
• Transfer organization ownership (owners only, via API)

Viewing Team Members

Navigate to Organization in the sidebar to see:

• Organization Info: Name, creation date, your role
• Members List: All team members with their roles and status
• Usage Stats (admins): Per-member usage breakdown

Member Information

Each member entry shows:

Field	Description
Name	First and last name
Email	Account email
Role	Owner, Admin, or Member
Status	Active, Suspended, or Pending

Roles

Owner

Organization owner with full control:

• All admin permissions
• Change member roles (promote/demote)
• Transfer ownership to another member
• Cannot be removed (must transfer ownership first)
• Only one owner per organization

Admin

Full organization management:

• Invite new members
• Remove members
• Suspend/activate members
• View all member usage
• Access audit logs
• Manage pending invitations
• Cannot change roles or transfer ownership

Member

Standard access:

• Use the platform
• View own usage
• Manage own profile and API keys
• Cannot manage other members

Inviting Members

Admin or Owner only

1. Click Invite Member
2. Enter the email address
3. Select a role (Admin or Member)
4. Click Send Invite

Invitation Flow

1. Invited user receives email
2. They click the invite link
3. They create their account or sign in
4. They complete onboarding
5. They're added to your organization

Pending Invitations

View and manage pending invites:

• See who hasn't accepted yet
• Check expiration dates
• Resend pending, still-valid invitations
• Revoke invitations if needed

To tidy up in one step, use Clean up expired to remove all expired invites at once. This only removes invitations that have already expired — pending, still-valid invites are left untouched.

Resending Invitations

If a pending, still-valid invitation wasn't received:

1. Go to Pending Invitations
2. Find the invitation
3. Click Resend
4. A reminder email is sent with a fresh invitation link

The reminder email is clearly marked as a reminder and includes a new link. Resending invalidates the previous link — only the most recent invitation works, so ask the recipient to use the latest email if they received more than one.

note

Resending is rate-limited with a short cooldown (30 seconds). Expired invitations cannot be resent — the API returns 410 Gone with the instruction to cancel it and create a new invitation. Revoke the expired invite and send a fresh one instead.

Via API

POST /api/v1/tenant-admin/invites/{invite_id}/resend
Authorization: Bearer <token>

Managing Members

Admin or Owner only

Suspend a Member

Temporarily disable access:

1. Find the member in the list
2. Click the Pause icon
3. Member status changes to "Suspended"

Suspended members:

• Cannot access the portal
• Cannot make API requests
• Keep their data and settings

Activate a Member

Re-enable access:

1. Find the suspended member
2. Click the Play icon
3. Member status changes to "Active"

Unlock a Member

If a member's account is temporarily locked after too many failed sign-in attempts, you can unlock it without waiting for the lock to expire:

1. Find the locked member
2. Click Unlock
3. The member can sign in again immediately

This clears the lock only; it does not change the member's password or status.

Remove a Member

Removing a member suspends their account — it is a reversible suspension, not a permanent deletion:

1. Find the member
2. Click the Remove button
3. Confirm removal

The member immediately loses access to the portal and the API, but their account and data are kept. Access can be restored later by reactivating the member.

Changing Member Roles

Owner only

1. Find the member in the list
2. Click the role dropdown or edit button
3. Select new role (Admin or Member)
4. Confirm the change

Note: Only owners can change roles. Admins cannot promote other members to admin or demote existing admins.

Via API

PUT /api/v1/tenant-admin/users/{user_id}/role
Authorization: Bearer <token>
Content-Type: application/json

{
  "role": "admin"
}

Available roles: admin, user

Transferring Ownership

Owner only

Ownership transfer is currently API-only — there is no transfer control in the portal UI. Transfer your organization ownership to another member via the endpoint below.

After transfer:

• You become an admin
• The new owner has full control
• This action cannot be easily undone

Via API

POST /api/v1/tenant-admin/transfer-ownership
Authorization: Bearer <token>
Content-Type: application/json

{
  "new_owner_id": "user-uuid-here"
}

Important: The new owner must be an existing member of the organization.

Usage Statistics

Admin or Owner only

Admins can see per-member usage:

Metric	Description
Requests	Total API requests made
Tokens	Total tokens consumed
Cost	Total cost incurred

This helps you:

• Identify heavy users
• Track team spending
• Optimize resource allocation

Audit Logs

Admin or Owner only

View organization activity history:

• Timestamp: When the action occurred
• User: Who performed the action
• Action: What was done
• Details: Additional context

Tracked Actions

• Member invitations sent
• Member invitations revoked
• Member removals
• Role changes
• Suspensions/activations
• Ownership transfers
• And more...

Via API

GET /api/v1/tenant-admin/audit-logs
Authorization: Bearer <token>

Query parameters:

• action: Filter by action type
• page: Page number
• page_size: Items per page

Your Profile

Everyone can edit their own profile — this is done on the Profile page, not the Organization page:

Editable Fields

• First name
• Last name
• Phone number

Read-Only Fields

• Email (contact admin to change)
• Organization name
• Member since date
• User ID
• Organization ID

Copying IDs

Click on User ID or Organization ID to copy to clipboard. Useful for:

• Support requests
• API debugging
• Integration setup

Best Practices

For Owners

1. Be careful with ownership transfer - It cannot be easily reversed
2. Limit admin roles - Only grant admin to those who need it
3. Review role changes - Regularly audit who has elevated permissions

For Admins

1. Review invitations - Clean up expired invites regularly
2. Monitor usage - Check team usage patterns
3. Use audit logs - Track important changes
4. Document decisions - Note why members were suspended/removed

For Members

1. Keep profile updated - Accurate info helps team communication
2. Report issues - Contact your admin for access problems
3. Secure your account - Use strong passwords

API Reference

Tenant Admin Endpoints

Method	Endpoint	Description	Access
GET	/api/v1/tenant-admin/users	List all users	Admin, Owner
PUT	/api/v1/tenant-admin/users/{id}/role	Update user role	Owner
POST	/api/v1/tenant-admin/users/{id}/suspend	Suspend user	Admin, Owner
POST	/api/v1/tenant-admin/users/{id}/activate	Activate user	Admin, Owner
POST	/api/v1/tenant-admin/users/{id}/unlock	Unlock a locked user	Admin, Owner
GET	/api/v1/tenant-admin/invites	List invites	Admin, Owner
POST	/api/v1/tenant-admin/invites	Create invite	Admin, Owner
DELETE	/api/v1/tenant-admin/invites/expired	Clear all expired invites	Admin, Owner
DELETE	/api/v1/tenant-admin/invites/{id}	Revoke invite	Admin, Owner
POST	/api/v1/tenant-admin/invites/{id}/resend	Resend invite	Admin, Owner
POST	/api/v1/tenant-admin/transfer-ownership	Transfer ownership	Owner
GET	/api/v1/tenant-admin/audit-logs	Get audit logs	Admin, Owner

Troubleshooting

"Cannot invite member"

• Check if you have admin or owner role
• Verify email format
• Check organization member limits

"Member not receiving invite"

• Check spam/junk folders
• Verify email address
• Resend the invitation

"Cannot remove member"

• You cannot remove yourself
• You cannot remove the owner (ownership must be transferred first)
• Contact platform admin for help

"Cannot change role"

• Only owners can change roles
• You cannot change the owner's role (use ownership transfer instead)
• Contact the organization owner

"Cannot transfer ownership"

• Only the current owner can transfer
• The target user must be an existing member
• Contact platform support if issues persist