> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetypeai.app/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Start with /introduction/getting-started. Use the Direct Query API (POST /query) with the Newton Fusion model (text, image, and video reasoning) or the Newton Omega encoder (time-series embeddings). ATAI_API_ENDPOINT must include the version path: /v0.5 for most APIs, /v0.6 for the Fine-Tuning Service. Pages whose descriptions are marked (Archived) document the legacy Lens runtime — do not use them for new projects.

# Organization Administration

> Administrate your organization using the Developer Console's **Organization Admin** page.

<Columns cols={2}>
  <Column>
    <img src="https://mintcdn.com/archetypeai-bd6fb3cf/8GVYBoCPMF0mLS3M/developer-console/org-admin/account-menu-org-admin.png?fit=max&auto=format&n=8GVYBoCPMF0mLS3M&q=85&s=bbd04063a1cba58618026d1f57a27890" alt="Developer Console sidebar for organization administrators" style={{height: "500px", "margin-top": "0"}} width="638" height="1160" data-path="developer-console/org-admin/account-menu-org-admin.png" />
  </Column>

  <Column>
    <p>
      If you are an administrator for your organization, the Archetype Developer Console offers access
      to organization administration features through the **Organization Admin** option in the account
      panel at the bottom of the sidebar.
    </p>

    <p>
      With this interface, you can view and manage your organization's users and their API
      keys and add and delete users. In addition, you can set the default role for new SSO users.
    </p>
  </Column>
</Columns>

To manage your organization, click the **Organization Admin** option in the sidebar. This opens
the **Organization Admin** page:

<img src="https://mintcdn.com/archetypeai-bd6fb3cf/8GVYBoCPMF0mLS3M/developer-console/org-admin/org-admin-main.png?fit=max&auto=format&n=8GVYBoCPMF0mLS3M&q=85&s=0b5c3896a533567072ff137109f8048c" alt="The main Organization Admin page" width="2720" height="1708" data-path="developer-console/org-admin/org-admin-main.png" />

## Organization Details

The **Organization Admin** page displays at the top of the page a box containing information
about the organization:

* The organization's "slug," which is a short-form human-readable identifier for the
  organization.
* The organization's unique ID, starting with `org_`.
* The number of members in the organization, as well as the number of currently deactivated
  members.
* The organization's default role; this is the role automatically assigned to new SSO users.

## Changing the Default Role

To change the default role applied to new SSO users, click the **Edit** button to the right of
the current default role in the **Details** panel at the top of the page.

<img src="https://mintcdn.com/archetypeai-bd6fb3cf/8GVYBoCPMF0mLS3M/developer-console/org-admin/org-admin-edit-default-role.png?fit=max&auto=format&n=8GVYBoCPMF0mLS3M&q=85&s=fa191bda5716e3f9b537b6906e5d97fa" alt="Setting the default role" width="1374" height="742" data-path="developer-console/org-admin/org-admin-edit-default-role.png" />

Use the **Default Role** popup to choose the default role for automatically-created SSO users;
these are users created automatically when they are part of your SSO cohort and attempt to sign
in, but do not yet have member accounts in your Archetype organization.

Each possible role is described in the user interface:

* **Viewer**: A safe default which grants read-only access to content.
* **Developer**: A role which allows the user to manage their own API keys.
* **Admin**: A role which grants full-organization administrative access. Every new SSO user is
  becomes an administrator by default. **Use with caution.**

## Managing Members

Below the organization **Details** panel is a list of the organization's members. At the top of
the list is a row including the following:

* A popup which lets you filter by the user's role.
* A search box.
* The **+ Add Members** button.

### Adding Members

To add one or more new users to your organization, click the **+ Add Members** button above the
top-right corner of the user list. This opens the **Add Members** dialog:

<img src="https://mintcdn.com/archetypeai-bd6fb3cf/8GVYBoCPMF0mLS3M/developer-console/org-admin/org-admin-add-members.png?fit=max&auto=format&n=8GVYBoCPMF0mLS3M&q=85&s=cdc7b04bca2d3a11db9864928af03c0a" alt="The Add Members panel" width="2152" height="1040" data-path="developer-console/org-admin/org-admin-add-members.png" />

To add a member, enter their email address, first name, last name, and their role. To add
another member, click the **+** button at the right side of the row. Continue adding members
until they've all been added, then click the **Create *N* Users** button (where *N* is the
number of users to create).

You can optionally bulk add multiple users at once by clicking the **Bulk add** button at the
bottom-left of the panel. This opens the **Bulk add members** panel:

<img src="https://mintcdn.com/archetypeai-bd6fb3cf/8GVYBoCPMF0mLS3M/developer-console/org-admin/org-admin-bulk-add.png?fit=max&auto=format&n=8GVYBoCPMF0mLS3M&q=85&s=fe9f849a4b591948226e663ec5644f74" alt="Bulk add members panel" width="1366" height="764" data-path="developer-console/org-admin/org-admin-bulk-add.png" />

This panel lets you enter all the users in the format:

```
Email,Firstname,Lastname,Role
```

For example:

```
miguel.garcia@example.com,Miguel,Garcia,developer
alice.thomas@example.com,Alice,Thomas,admin
john.doe@example.com,John,Doe,viewer
```

If you paste CSV in the given format, a header row is automatically ignored if it exists.

Once you've entered (or pasted) all the users' information into the edit box, click the **Add *N*
to list** button (where *N* is the number of users in the list).

### Changing a User's Role

To change a user's role, click on the role popup in the user's row in the user list. Choose
their new role from the list.

### Managing a Member's API Keys

To manage a member's API keys, click the key icon to the right of the user's information in the
main Organization Admin panel. This opens the API keys panel for that user. For example:

<img src="https://mintcdn.com/archetypeai-bd6fb3cf/8GVYBoCPMF0mLS3M/developer-console/org-admin/org-admin-api-keys.png?fit=max&auto=format&n=8GVYBoCPMF0mLS3M&q=85&s=12cb537533b78766e87407b71cbb688a" alt="API keys for user panel" width="1370" height="898" data-path="developer-console/org-admin/org-admin-api-keys.png" />

At the top is the user's name. Below is a list of the user's API keys, both active and revoked.
Each row in the list displays both the key's name and the key's ID. Secret API keys (the ones
you provide to the Archetype API) are not displayed.

To revoke an active key, press the <Icon icon="trash-can" /> (trash can) icon at the right end of
the key's information row.

<Warning>
  Clicking the <Icon icon="trash-can" /> (trash can) icon to revoke a key takes effect
  *immediately*. There is no confirmation request before revocation occurs, and revoked keys
  cannot be reactivated. Be careful.
</Warning>

### Deactivating a Member

To deactivate the account belonging to a member of your organization, click the **<Icon icon="trash-can" />** (trash can) icon that appears in the row of the user you want to
deactivate. Confirm the deactivation when asked to do so.

<Warning>
  Once a user has been deactivated, they cannot be reactivated.
</Warning>
