> Documentation index: [/llms.txt](/llms.txt). Every page as one file: [/llms-full.txt](/llms-full.txt).

# Key concepts

Key concepts [#key-concepts]

Work in Alomana happens in workspaces; people join them with a role, and an organization can group the people and workspaces of one company.

Organizations, workspaces and members [#organizations-workspaces-and-members]

| Level        | What it is                                                                                           | Rules                                                  |
| ------------ | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
| Organization | The people of one company, with shared roles and plans for its workspaces.                           | You belong to at most one. Many accounts have none.    |
| Workspace    | Where work happens: chats, agents, skills, Library files, connectors and apps live in one workspace. | You can belong to many and switch between them.        |
| Member       | A person in a workspace.                                                                             | Has exactly one role in each workspace they belong to. |

* A workspace created by a member of an organization belongs to it and uses its roles; other workspaces use the standard ones.
* Joining an organization moves the workspaces you created into it and takes you out of workspaces outside it. Leaving changes no workspace.
* Your organization role, such as **Admin** or **Member**, is shown on your [profile](/docs/platform/account/profile).

Roles in a workspace [#roles-in-a-workspace]

Each workspace has three built-in roles. These are the defaults; an organization or workspace admin can change what each role may do.

| Role       | By default can                                                                                    |
| ---------- | ------------------------------------------------------------------------------------------------- |
| **Member** | Chat, create and edit agents, connectors, MCP servers and workflows, and open apps.               |
| **Editor** | Everything a Member can, plus publish agents, edit apps, and create API keys and magic links.     |
| **Admin**  | Everything, including inviting and removing members, changing roles and the workspace's settings. |

Whoever creates a workspace is its Admin. See [Roles and permissions](/docs/platform/admin/workspace/roles-and-permissions) for the full list.

People chat with an agent's published version, so a new agent is usable only once a role that may publish, **Editor** or **Admin** by default, publishes it. See [Test and publish an agent](/docs/platform/agents/test-and-publish).

What is private and what is shared [#what-is-private-and-what-is-shared]

| Item                                              | Who sees it                                                                                                                                                           |
| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Chats                                             | Only you, and only in the workspace where you started them, until you [share one](/docs/platform/chat/share-and-collaborate). Workspace admins do not see your chats. |
| Files you attach to a chat                        | Only you, inside that chat.                                                                                                                                           |
| Scheduled tasks                                   | Only you, in the workspace where you created them.                                                                                                                    |
| Agents, skills, skill sets and prompts you create | Everyone in the workspace.                                                                                                                                            |
| Library files and folders                         | Everyone in the workspace.                                                                                                                                            |
| Connectors                                        | **Private** (only you) or **Space** (everyone in the workspace), chosen when you add one. New connectors are **Private**.                                             |
| Apps                                              | Set per app. See [Share an app](/docs/platform/apps/share-and-access).                                                                                                |
| Profile, plan and credits                         | Only you, the same in every workspace.                                                                                                                                |

Some shared connectors still ask each person to connect their own account before an agent can use them. See [Reconnect a connector](/docs/platform/connectors/reconnect).

Credits [#credits]

Credits measure what your work uses (model replies, tools such as web search and image generation, and code that agents run), and your plan gives you an allowance of them across all your workspaces. See [Usage and limits](/docs/platform/account/usage-and-limits).

To manage organizations, workspaces and roles with an API key, see [Organizations and workspaces](/docs/api/workspaces/organizations-and-workspaces) in the API documentation.