Getting Started

Managing Members

Learn how to invite, manage, and organize team members in your LangMart organization.

Member Roles

Organizations support the following roles:

Role Permissions
Owner Full control, including organization deletion and ownership transfer
Admin Manage members, settings, billing, and API keys
Developer Use models and view usage; cannot manage organization
Viewer View-only access to organization information
Member Standard member with model access

Role Hierarchy

Owners and admins can assign roles up to their own level:

  • Owners can assign any role including admin
  • Admins can assign developer, viewer, or member roles
  • Developers/Viewers/Members cannot assign roles

Inviting Members

Via Web Interface

  1. Navigate to your organization settings
  2. Go to Members tab
  3. Click Invite Member
  4. Enter the email address
  5. Select a role
  6. Optionally add a personal message
  7. Click Send Invitation

Invitation Process

  1. Invitee receives an email with invitation link
  2. Link valid for 7 days
  3. Invitee clicks link and logs in (or creates account)
  4. Email address must match the invited email
  5. Member is added to the organization

Pending Invitations

View and manage pending invitations:

  • See all outstanding invitations
  • Resend invitations if needed
  • Revoke invitations before they're accepted
  • Check expiration dates

Via API

Invite Member

POST /api/organizations/:org_id/members/invite
Content-Type: application/json
Authorization: Bearer <your-api-key>

{
  "email": "[email protected]",
  "role": "developer",
  "message": "Welcome to the team!"
}

List Members

GET /api/organizations/:org_id/members
Authorization: Bearer <your-api-key>

Response:

{
  "success": true,
  "members": [
    {
      "user_id": "uuid",
      "email": "[email protected]",
      "display_name": "John Doe",
      "role": "admin",
      "status": "active",
      "joined_at": "2024-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "total": 15,
    "limit": 50,
    "offset": 0
  }
}

Updating Member Roles

Change a Member's Role

  1. Go to Organization > Members
  2. Find the member you want to update
  3. Click the role dropdown or edit button
  4. Select the new role
  5. Confirm the change

Role Change Restrictions

  • Cannot demote the last owner (at least one owner required)
  • Cannot assign roles higher than your own
  • Role changes take effect immediately
  • Member will see new permissions on next page load

Via API

PUT /api/organizations/:org_id/members/:user_id
Content-Type: application/json
Authorization: Bearer <your-api-key>

{
  "role": "admin"
}

Removing Members

Remove a Member

  1. Navigate to Organization > Members
  2. Find the member to remove
  3. Click Remove or the delete icon
  4. Confirm the removal

What Happens When a Member is Removed

  • Member loses access to organization resources immediately
  • Their API keys scoped to the organization are revoked
  • Usage history is retained for billing purposes
  • Member can be re-invited later if needed

Restrictions

  • Cannot remove the last owner
  • Owners can remove any member except themselves (if last owner)
  • Admins can remove members with lower roles

Via API

DELETE /api/organizations/:org_id/members/:user_id
Authorization: Bearer <your-api-key>

Switching Organizations

Users who belong to multiple organizations can switch between them.

Switch Your Active Organization

  1. Click on your profile or organization name in the header
  2. Select Switch Organization
  3. Choose the organization you want to work in
  4. Your context updates to the selected organization

Via API

PUT /api/user/primary-organization
Content-Type: application/json
Authorization: Bearer <your-api-key>

{
  "organization_id": "target-org-uuid"
}

What Changes When You Switch

  • API calls use the new organization's context
  • You see models and connections from the new organization
  • Spending counts toward the new organization's limits
  • Your role may differ between organizations

Accepting Invitations

Accept an Invitation

  1. Open the invitation email
  2. Click the invitation link
  3. Log in to your LangMart account (or create one)
  4. Your email must match the invited email
  5. You're now a member of the organization

Via API

POST /api/organizations/invitations/accept
Content-Type: application/json
Authorization: Bearer <your-api-key>

{
  "token": "invitation-token-from-email"
}

Managing Permissions

Member Permissions

Beyond roles, you can assign specific permissions:

Permission Description
manage_members Can invite and remove members
manage_billing Can view billing and add credits
manage_settings Can modify organization settings
manage_api_keys Can create and revoke API keys
view_usage Can view usage statistics
use_models Can access organization models

Custom Permission Assignment

PUT /api/organizations/:org_id/members/:user_id
Content-Type: application/json
Authorization: Bearer <your-api-key>

{
  "permissions": ["manage_members", "view_usage", "use_models"]
}

Member Spending Limits

Setting Individual Limits

Control how much each member can spend:

PUT /api/organizations/:org_id/spending-limits
Content-Type: application/json
Authorization: Bearer <your-api-key>

{
  "user_id": "member-uuid",
  "monthly_limit": 100.00,
  "daily_limit": 10.00
}

Viewing Member Spending

Track individual member usage in Organization > Billing > Member Spending.

Best Practices

Onboarding New Members

  1. Send clear welcome communication about available resources
  2. Start with appropriate role (don't over-permission)
  3. Set reasonable spending limits initially
  4. Document internal usage policies

Regular Maintenance

  • Review member list quarterly
  • Remove inactive members
  • Audit roles and permissions
  • Monitor for unusual usage patterns

Security

  • Use viewer role for contractors who only need read access
  • Rotate admin access when team members leave
  • Enable auto-approve only for trusted domains

Next Steps