Rejoining... Retrying in s Connection lost Session paused Resume failed
Ariadne User Documentation
Documentation for how to use the Ariadne platform

account-and-organisation

Last updated 13 September 2026

Account & Organisation

This guide covers user profile management, API access, organisations, and subscriptions.

My Profile

Go to User Menu → My Profile to manage your personal details.

From your profile you can:

  • Update your display name
  • Change your password
  • Set preferences such as default language and timezone
  • View your account ID and registration date

Authorise Access (API Tokens)

Go to User Menu → Authorise Access to manage API tokens.

What Are API Tokens?

API tokens allow external applications and scripts to access Ariadne's API on your behalf, without using your password. Tokens are used for:

  • Connecting the Console App to a remote Ariadne instance
  • Accessing the Ariadne API from your own code or integrations
  • Authorising third-party tools to interact with your conversations

Creating a Token

  1. Click New Token
  2. Give the token a descriptive name (e.g. "Console App - Work Laptop")
  3. Set an optional expiry date (recommended for security)
  4. Configure permissions & scoping:
    • Allowed Model Names: Restrict the token to execute requests only on specific, whitelisted models.
    • Router Management: Grant the token least-privilege permission to manage model router configurations (such as CRUD operations on models or hosts and viewing usage statistics).
  5. Click Create
  6. Copy the token immediately — it is only shown once

Revoking a Token

To revoke a token, find it in the list and click Revoke. Any application using that token will immediately lose access.

Security Best Practices

  • Create a separate token for each application or device
  • Set expiry dates for tokens used in scripts or automated pipelines
  • Revoke tokens that are no longer in use
  • Never share tokens in code repositories or chat messages

My Organisation

Go to User Menu → My Organisation to manage your organisation.

What Is an Organisation?

An organisation groups multiple Ariadne users together, allowing them to share agents, conversations, and resources. Organisations are useful for teams and businesses.

Creating an Organisation

If you don't belong to an organisation yet:

  1. Go to My Organisation
  2. Click Create Organisation
  3. Enter your organisation name
  4. Click Save

You become the organisation owner.

Inviting Members

  1. Go to My Organisation
  2. Click Invite Member
  3. Enter the user's email address
  4. Select a role:
    • Owner – full administrative access
    • Member – standard access
  5. Click Send Invite

The invited user will receive an invitation to join.

Managing Members

From the Members list you can:

  • View all current members
  • Change a member's role
  • Remove a member from the organisation

Joining an Organisation

If you've been invited to an organisation, you'll receive an invitation link by email. Click the link to accept and join.

OIDC / Single Sign-On

Organisations can configure OIDC (OpenID Connect) for Single Sign-On, allowing members to log in using your existing identity provider (e.g. Microsoft Entra, Google Workspace, Okta).

To configure SSO:

  1. Go to My Organisation → OIDC Providers
  2. Click Add Provider
  3. Enter your identity provider's configuration (Client ID, Client Secret, Discovery URL)
  4. Click Save

Once configured, users can log in via the SSO button on the Ariadne login page.

My Subscription

Go to User Menu → My Subscription to view your current subscription plan, usage, and billing.

Subscription Plans

Ariadne supports tiered subscription plans. Your plan determines:

  • Available features and tool access
  • Usage limits (API calls, storage, etc.)
  • Number of users in your organisation

Viewing Usage

The Subscription page shows current usage metrics, helping you monitor consumption and plan upgrades accordingly.

Upgrading or Changing Plan

Click Upgrade or Change Plan to modify your subscription. If Stripe payment integration is enabled on your instance, you can manage billing directly from this page.

Voice Accessories

Go to User Menu → My Voice Accessories to configure voice input and output devices.

Ariadne supports voice interaction via connected voice satellites (e.g. Wyoming-compatible voice hardware). From this page you can:

  • Register a new voice satellite device
  • Configure the microphone and speaker settings for voice interaction
  • Test the voice connection

Physical Accessories

Go to User Menu → My Physical Accessories to configure physical hardware integrations such as smart buttons, indicator lights, or other IoT devices that can trigger or receive signals from Ariadne.

My Email Addresses

Go to User Menu → My Email Addresses to manage the email addresses associated with your Ariadne account.

These identities are used for:

  • Routing incoming emails to your conversations
  • Identifying you as the sender when agents send emails on your behalf
  • Matching webhook payloads and external triggers to your account

Admin Security & Password Hashing

Ariadne employs enterprise-grade cryptographic standards to protect administrative and user access. Local administrative passwords and user credentials are database-backed and secured using robust PBKDF2 hashing with salt-stretching. This ensures high resistance to brute-force attacks even in fully self-hosted, air-gapped environments.

Security Recommendations

  • Use a strong, unique password for your Ariadne account
  • Enable SSO via your organisation's identity provider if available
  • Regularly review and revoke unused API tokens
  • Use token expiry dates for automated access
  • Remove organisation members promptly when they leave the team