Getting Started

Creating an Organization

This guide walks you through setting up a new organization in LangMart.

Prerequisites

Before creating an organization:

  • You must have a registered LangMart account
  • You cannot already be the owner of another organization
  • Contact support if you need to manage multiple organizations

Creating Your Organization

Step 1: Navigate to Organizations

  1. Log in to your LangMart account
  2. Go to Settings or navigate directly to the Organizations page
  3. Click Create Organization

Step 2: Basic Information

Fill in the required organization details:

Field Required Description
Name Yes Your organization's display name
Description No Brief description of your organization
Billing Email No Email for billing communications (defaults to your email)
Website No Your organization's website URL

Step 3: Initial Setup

After creation, you will automatically be:

  • Assigned as the organization Owner
  • Given full administrative permissions
  • Ready to invite members and configure settings

Organization Settings

General Settings

Configure your organization's core settings:

  • Organization Name: The display name shown to members and on the platform
  • Description: Helps potential members understand your organization's purpose
  • Website: Optional link to your organization's website
  • Billing Email: Where billing notifications and invoices are sent

Member Settings

Control how members join and interact:

  • Member Limit: Maximum number of members (default varies by plan)
  • Allow Join Requests: Whether users can request to join
  • Auto-Approve Requests: Automatically approve join requests

API Settings

Configure API access for your organization:

  • API Rate Limit: Maximum requests per minute for organization members
  • Default Spending Limits: Per-member spending limits applied to new members

Billing Configuration

Setting Up Credits

Organizations use a credit-based system:

  1. Navigate to Organization Billing
  2. Click Add Credits
  3. Enter the amount (USD)
  4. Complete the payment process

Spending Limits

Control costs by setting spending limits:

Limit Type Description
Monthly Organization Limit Total spending cap for the organization
Per-Member Monthly Limit Maximum each member can spend per month
Per-Member Daily Limit Maximum each member can spend per day

Viewing Billing Information

Access billing details through:

  1. Organization > Billing - Overview of credits and spending
  2. Usage Tab - Detailed breakdown by member and model
  3. Transactions - History of credit purchases and usage

Configuring Model Access

Adding Connections

Make models available to your organization:

  1. Go to Connections page
  2. Add provider connections (OpenAI, Anthropic, etc.)
  3. Set the connection scope to Organization
  4. Configure billing mode (org-pays or member-pays)

Connection Billing Modes

Mode Description Best For
Organization Pays Organization covers all usage costs Core team tools, approved workflows
Member Pays Members pay from their own credits Optional or experimental models

Best Practices

Security

  • Use strong API keys and rotate them regularly
  • Limit admin access to trusted team members
  • Review member activity periodically
  • Set appropriate spending limits

Cost Management

  • Start with conservative spending limits
  • Monitor usage patterns before increasing limits
  • Use org-pays sparingly for high-cost models
  • Set up alerts for unusual spending

Member Management

  • Clearly communicate usage policies to members
  • Document which models are available and their purposes
  • Regularly review member access and remove inactive users
  • Consider auto-approval for trusted domains

API Reference

Create Organization

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

{
  "name": "My Organization",
  "description": "Team workspace for AI projects",
  "billing_email": "[email protected]",
  "website": "https://example.com"
}

Update Organization

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

{
  "name": "Updated Name",
  "description": "Updated description"
}

Next Steps