Organizations

Organizations are the primary unit of collaboration and billing in Xinference. They group users together under a shared namespace with unified billing.

Structure

Organization
├── Members (with roles: super_admin, admin, member, viewer)
├── Billing Account
├── Deployments (created by any member)
└── Settings (notifications)

Creating an Organization

An organization is created for you during sign-up — the organization field is required when you register. The account that registers becomes the organization's super_admin (which also holds billing permission).

Organization Slug

The slug is a short identifier used in API responses and URLs (e.g. my-company). It must be: - Lowercase letters, numbers, and hyphens only - 3–64 characters - Unique across all organizations

The slug cannot be changed after creation.

Switching Between Organizations

If your account belongs to multiple organizations, use the organization switcher in the top navigation bar. All dashboard views (deployments, billing, members) are scoped to the active organization.

Personal vs. Organization Deployments

Deployments created while a personal account (no organization selected) are billed to your personal billing account. Deployments created within an organization are billed to the organization's billing account.

API Access

API requests are authenticated with the session cookie set when you sign in (see Authentication). Requests are automatically scoped to the organization associated with the signed-in user — there is no separate organization-ID parameter.

# Deployments are scoped to the signed-in user's organization
import requests

requests.get(
    "https://api.xinference.co/api/v1/model-deployments",
    cookies={"session": "<your-session-cookie>"},
)