Manage your organisation

Create an organisation, invite members, assign teams, manage API keys and secrets, and configure org-level AI providers.

An organisation is a shared workspace. Members of an organisation can collaborate on agent apps, share knowledge bases, and use org-level resources (providers, secrets, API keys). Most production deployments run inside an organisation.

Create an organisation

1. Click your account name in the top bar → Organisations.
2. Click New Organisation.
3. Enter a Name and Slug (the short URL identifier). The slug is permanent.
4. Optionally set an Auto-join domain — any user who signs up with an email address from that domain is automatically added to the organisation.

Invite members

Go to Organisation → People and click Invite Member. Enter the email address. The invited user receives a link and is added to the organisation on first login.

Roles

Teams

Teams are sub-groups within an organisation. Use them to control which agent apps and resources a group of members can access.

1. Go to Organisation → Teams.
2. Click New Team, give it a name.
3. Add members to the team.
4. Assign teams to specific agent apps in the app's Access tab.

Organisation API keys

Org API keys authenticate API calls to agents on behalf of the organisation (not any individual user). Use them in server-side integrations where you don't want to expose a user's personal key.

Go to Organisation → API Keys → New API Key. Give it a descriptive name and copy the generated key — it is shown only once.

Use it in the Authorization: Bearer <key> header for API requests.

Secrets

Secrets store sensitive values (API keys, tokens, passwords) and expose them to agent apps as environment variable references. Storing values as secrets means they never appear in plain text in your agent configuration.

Create a secret

Go to Organisation → Secrets → New Secret.

• Name — the reference name used in configurations, e.g., OPENAI_API_KEY
• Value — the secret value (stored encrypted at rest)

Use a secret

Reference a secret anywhere in your agent configuration with ${SECRET_NAME}:

# In an API skill header
Authorization: Bearer ${OPENAI_API_KEY}
 
# In an MCP server environment variable
env:
  DATABASE_URL: ${DATABASE_URL}

Secrets are resolved at runtime and never exposed in logs or API responses.

Configure org-level AI providers

Org-level providers are shared across all members and agent apps in the organisation. Members use org providers without needing to configure their own API keys.

Go to Organisation → Providers → Add Provider.

For each provider, enter:

• Provider type — Anthropic, OpenAI, Google Gemini, Groq, Ollama, Amazon Bedrock, NVIDIA NIM, xAI, or any OpenAI-compatible custom endpoint
• Base URL — for custom providers
• API key — use a secret reference rather than a raw key

See Configure LLM providers for per-user provider setup.

Organisation settings

Organisation → Settings controls:

• Name and Slug — rename the org (slug changes affect all URLs)
• Auto-join domain — automatically add users who sign up with a matching email domain
• Delete organisation — permanent; removes all data including agent apps, knowledge bases, and secrets

Only owners can delete an organisation.