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

# Overview

Alomana API documentation [#alomana-api-documentation]



The Alomana API serves the same endpoints as the Alomana web app, so a script or coding agent can do with an API key what a user does in the browser.

<PlatformArchitecture />

Start here [#start-here]

* [Get started](/docs/api/get-started): make your first call with an API key.
* [Authentication and API keys](/docs/api/api-basics/authentication): choose a key and send it.
* [Run an agent and stream its events](/docs/api/configurable-agents/run-and-stream): get an agent's answer.
* [Set up a client](/docs/api/workspaces/set-up-a-client): create an organization, a workspace, roles and members with one platform key.

Concepts [#concepts]

| Concept                  | What it is                                                                                                   |
| ------------------------ | ------------------------------------------------------------------------------------------------------------ |
| **Workspace**            | The boundary for data, agents, connections, members and usage. Selected on each request with `X-Space-Slug`. |
| **Organization**         | An optional group of workspaces that share custom roles and role changes.                                    |
| **Agent**                | A reusable resource built from a model, prompts, tools, skills, Files scopes and connections.                |
| **Connectors and Files** | Credential-managed access to external systems, and searchable workspace knowledge.                           |