Organizations

Documentation Index

Fetch the complete documentation index at: https://docs.lyceum.technology/llms.txt

Use this file to discover all available pages before exploring further.

​

Concepts

• Default org — Every user has exactly one membership flagged as their default. Requests that don’t pin an org fall back to it. The default is created at signup and you must always have one.
• Active org — The org the dashboard (or CLI) is currently acting on. The org switcher in the sidebar changes the active org; under the hood the dashboard sends X-Org-Slug: <slug> on every request.
• Roles — Each member of an org has one of three roles:

  Role	Can do
  owner	Everything: change roles, edit org name/slug/billing email, delete the org
  admin	Manage members, invites, and API keys
  member	Read org details, see balance, use the org’s API keys and credits

• Slug — A short URL-safe identifier (a-z, 0-9, -). Slugs are unique platform-wide and stable URLs in the dashboard (/orgs/{slug}). They can be renamed by an owner.

​

Using the dashboard

• See every org you belong to and your role in each
• Switch the active org — every page in the dashboard refetches against the new org
• Open Organizations to create a new org, see pending invites you’ve received, or jump into an org’s settings

​

Inviting members

• Existing user — They’re added directly. They receive a “you’ve been added to Org Name” email and the invite shows status: "added".
• New user — A pending invite is created and an invite email is sent. The response is status: "invited". The link in that email goes to https://dashboard.lyceum.technology/invite/{token}. When the user signs up or signs in with the same email, the invite is auto-accepted by the auth hook.

​

Org context on API requests

1. API key with an embedded org_id — API keys created under /orgs/{slug}/api-keys are pinned to that org. Authentication and org context come from the key in a single step.
2. JWT + X-Org-Slug header — If you authenticated with a JWT, pass the slug of the org you want to act on as X-Org-Slug: <slug>. The server verifies that you’re a member of that org.
3. Fallback — If neither is provided, the request falls back to your default org.

# Explicit org via header
curl https://api.lyceum.technology/api/v2/external/billing/credits \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -H "X-Org-Slug: acme"

# Org pinned by the API key (no header needed)
curl https://api.lyceum.technology/api/v2/external/billing/credits \
  -H "Authorization: Bearer lk_..."

​

CLI

# Switch active org
lyceum org list
lyceum org use acme         # Pin acme as active
lyceum org current          # Show what's currently active
lyceum org unset            # Fall back to your default org

# Create / inspect / update / delete
lyceum org create "Acme Corp" --slug acme --billing-email billing@acme.com
lyceum org show              # Defaults to active org
lyceum org update --name "Acme Inc"
lyceum org delete acme

# Balance and ledger
lyceum org balance
lyceum org transactions list --kind debit --limit 50
lyceum org transactions aggregate --category vms --group-by hardware_profile

# Members
lyceum org members list
lyceum org members add user@example.com --role member
lyceum org members role <user_id> --role admin
lyceum org members remove <user_id>

# Invites
lyceum org invites list                   # Pending invites for this org
lyceum org invites revoke <invite_id>
lyceum org invites mine                   # Invites sent to your email
lyceum org invites accept <invite_id>

# Org-scoped API keys
lyceum org keys list
lyceum org keys create "ci-pipeline" --expires-at 2027-01-01T00:00:00Z
lyceum org keys revoke <key_id>

lyceum --org other-team workloads list   # or set LYCEUM_ORG=other-team

​

Billing

​

REST API

​

Orgs

​

Members

​

Invites

​

Org-scoped API keys