Authentication

curl -X POST https://api.modulex.dev/api-keys \
  -H "Authorization: Bearer $CLERK_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "CI/CD",
    "rate_limit_per_minute": 120
  }'

import asyncio
from modulex import Modulex

# Creating a key requires an authenticated user — either a Clerk JWT or an
# existing mx_live_ API key works, so an existing key can create another.
# You only need to bootstrap the very first key from a logged-in app session.
async def main():
    async with Modulex(api_key="mx_live_2J9vK4xM8nP3wQ7tR5sL1yB6cF0dG2h4vN8pX5mK9rT3wY7u") as client:
        key = await client.api_keys.create(name="CI/CD", rate_limit_per_minute=120)
        print(key.key)  # full key, shown once

asyncio.run(main())

import { Modulex } from 'modulex-js';

const client = new Modulex({
  apiKey: 'mx_live_2J9vK4xM8nP3wQ7tR5sL1yB6cF0dG2h4vN8pX5mK9rT3wY7u',
});

const key = await client.apiKeys.create({ name: 'CI/CD', rateLimitPerMinute: 120 });
console.log(key.key); // full key, shown once

# Verify the key — identity endpoint, no org header needed
curl https://api.modulex.dev/auth/me \
  -H "Authorization: Bearer mx_live_2J9vK4xM8nP3wQ7tR5sL1yB6cF0dG2h4vN8pX5mK9rT3wY7u"

import asyncio
from modulex import Modulex

async def main():
    async with Modulex(
        api_key="mx_live_2J9vK4xM8nP3wQ7tR5sL1yB6cF0dG2h4vN8pX5mK9rT3wY7u",
        organization_id="a1b2c3d4-e29b-41d4-a716-446655440000",
    ) as client:
        me = await client.auth.me()
        print(me)

asyncio.run(main())

import { Modulex } from 'modulex-js';

const client = new Modulex({
  apiKey: 'mx_live_2J9vK4xM8nP3wQ7tR5sL1yB6cF0dG2h4vN8pX5mK9rT3wY7u',
  organizationId: 'a1b2c3d4-e29b-41d4-a716-446655440000',
});

const me = await client.auth.me();
console.log(me);

# Per-call org override
llms = await client.organizations.llms(organization_id="other-org-uuid")

// Per-call org override
const llms = await client.organizations.llms({ organizationId: 'other-org-uuid' });