# Administrator guides

Set up and run your ATLAS organisation: people, providers, models, spaces, projects, budgets and sign-in.

If you're new, start with [Set up your first organisation](https://docs.atlas.ilionx.dev/getting-started/first-organisation.md). It takes you from an empty organisation to a first model request.

## Who can do what

Each guide lists the role it needs. The common ones are below. [Roles and permissions](https://docs.atlas.ilionx.dev/reference/roles-and-permissions.md) has the full matrix, and the [glossary](https://docs.atlas.ilionx.dev/reference/glossary.md) defines each role.

| Role            | Typical tasks                                                  | Start with                                                     |
| --------------- | -------------------------------------------------------------- | -------------------------------------------------------------- |
| Owner or Admin  | Manage people, spaces, providers, models, projects and budgets | [Manage organisation members](https://docs.atlas.ilionx.dev/guides/admin/organisations-manage-members.md) |
| Account Manager | Create and fund projects and manage their members and models   | [Create a project](https://docs.atlas.ilionx.dev/guides/admin/projects-create-a-project.md)               |
| Auditor         | Search the audit log and read prompts and responses            | [Search the audit log](https://docs.atlas.ilionx.dev/guides/admin/usage-and-audit-search-audit-log.md)    |
| Space manager   | Manage the people and budget of a space and its child spaces   | [Organise the space hierarchy](https://docs.atlas.ilionx.dev/guides/admin/spaces-organise-hierarchy.md)   |
| Project manager | Manage a project's keys, members and settings                  | [Manage project members](https://docs.atlas.ilionx.dev/guides/admin/projects-manage-members.md)           |

## API keys

| Guide                                                         | What it covers                                                                            |
| ------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| [Monitor and revoke API keys](https://docs.atlas.ilionx.dev/guides/admin/api-keys-monitor-and-revoke.md) | Review all API keys in your organisation, check the revocation history, and revoke a key. |

## Budget and cost

| Guide                                                                                                      | What it covers                                                                                              |
| ---------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| [Split a Team budget between members](https://docs.atlas.ilionx.dev/guides/admin/budget-and-cost-allocate-a-team-budget.md)                           | Share a Team's monthly budget between its members, and add daily or monthly spending limits.                |
| [Set the business time zone and download statements](https://docs.atlas.ilionx.dev/guides/admin/budget-and-cost-business-time-zone-and-statements.md) | Choose the time zone that sets budget periods, then find monthly invoices and allocation statements.        |
| [Set a space budget](https://docs.atlas.ilionx.dev/guides/admin/budget-and-cost-set-a-space-budget.md)                                                | Cap the monthly spend of a Division, Unit or Team. The gateway refuses requests once the budget is used up. |

## Gateway

| Guide                                                                                         | What it covers                                                                                  |
| --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| [Tune how a provider handles request parameters](https://docs.atlas.ilionx.dev/guides/admin/gateway-tune-provider-parameter-handling.md) | Stop a provider rejecting unrecognised request fields by denying, replacing or permitting them. |

## Identity and access

| Guide                                                                                  | What it covers                                                                                              |
| -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| [Configure Microsoft Entra ID sign-in](https://docs.atlas.ilionx.dev/guides/admin/identity-and-access-configure-entra-sign-in.md) | Connect an Entra tenant for sign-in and rotate the client secret.                                           |
| [Map Entra groups to ATLAS roles](https://docs.atlas.ilionx.dev/guides/admin/identity-and-access-map-entra-groups-to-roles.md)    | Use Entra security groups to set organisation roles and restrict sign-in to assigned groups.                |
| [Provision members with SCIM](https://docs.atlas.ilionx.dev/guides/admin/identity-and-access-provision-members-with-scim.md)      | Have Entra create, update and remove ATLAS members automatically, and cut over to directory-managed access. |

## Organisations

| Guide                                                          | What it covers                                                            |
| -------------------------------------------------------------- | ------------------------------------------------------------------------- |
| [Manage organisation members](https://docs.atlas.ilionx.dev/guides/admin/organisations-manage-members.md) | Change roles, transfer ownership, and remove people from an organisation. |

## Projects

| Guide                                                                                        | What it covers                                                                       |
| -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| [Configure a project's models and AI settings](https://docs.atlas.ilionx.dev/guides/admin/projects-configure-models-and-ai-settings.md) | Choose which models a project can use and set its standing instruction and defaults. |
| [Create a project](https://docs.atlas.ilionx.dev/guides/admin/projects-create-a-project.md)                                             | Create a project so a service or team gets its own keys, models and funding.         |
| [Fund a project or set a monthly limit](https://docs.atlas.ilionx.dev/guides/admin/projects-fund-a-project.md)                          | Give a Funded project budget, correct it, or cap a Tracked project per month.        |
| [Manage project members](https://docs.atlas.ilionx.dev/guides/admin/projects-manage-members.md)                                         | Add people to a project, change their role or remove them.                           |

## Providers and models

| Guide                                                          | What it covers                                                                                                 |
| -------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| [Add models to a provider](https://docs.atlas.ilionx.dev/guides/admin/providers-and-models-add-models.md) | Create model configurations one at a time from discovery, the catalogue or manual entry, or many at once.      |
| [Add an AI provider](https://docs.atlas.ilionx.dev/guides/admin/providers-and-models-add-provider.md)     | Connect OpenAI-compatible services, Azure, Anthropic, Amazon Bedrock or Ollama, then configure models on them. |

## Spaces

| Guide                                                        | What it covers                                                                              |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------- |
| [Organise the space hierarchy](https://docs.atlas.ilionx.dev/guides/admin/spaces-organise-hierarchy.md) | Create, relabel, move, budget and delete spaces so the tree mirrors your organisation.      |
| [Manage space policies](https://docs.atlas.ilionx.dev/guides/admin/spaces-manage-policies.md)           | Block models for a space and everything beneath it, and cap how long new API keys can live. |

## Usage and audit

| Guide                                                       | What it covers                                                                                                       |
| ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| [Explore usage](https://docs.atlas.ilionx.dev/guides/admin/usage-and-audit-explore-usage.md)           | Break spend down by space, project, user, model or provider, compare periods and see a month-end projection.         |
| [Search the audit log](https://docs.atlas.ilionx.dev/guides/admin/usage-and-audit-search-audit-log.md) | Find a specific AI request or conversation, inspect what happened, and trace it from a request ID or correlation ID. |
