Skip to main content

Open in AthenaHQ

app.athenahq.ai/settings/general

​
Purpose

The General Settings page acts as the primary hub for managing high-level organization details. It allows customers to view and edit their workspace’s name, see when it was created, and verify their current organizational role. For enterprise customers, this page houses the configurations for Single Sign-On (SSO) and SCIM (System for Cross-domain Identity Management) provisioning. Here, administrators can dictate the default role assigned to new SSO users and manage the API tokens required to sync user accounts from their identity provider. Additionally, this page provides quick links to other administrative areas (like billing, domain access, and user management) and contains the “Danger Zone” where the organization owner can permanently delete the entire workspace.

​
What you can do here

  • Edit: Opens the “Edit organization” dialog to rename the workspace. Disabled if you lack permission.
  • Manage quick links: Clicking “Users”, “Domain access”, “Billing”, or “Activity Log” takes you to those specific settings pages.
  • Default role for new users selector: Clicking the dropdown allows admins to pick a new default role (Standard or Custom) for incoming SSO users.
  • Generate SCIM token / Rotate SCIM token: Opens a dialog to create a new SCIM API token. You can type an optional name into the “Token label (optional)” field and click “Generate token” or “Rotate token”.
  • Click to copy: After generating a token, clicking the code block copies the token to your clipboard.
  • Done: Closes the SCIM dialog after you have copied your token.
  • How to set up SCIM in your identity provider: Expands or collapses the step-by-step setup guide.
  • Danger Zone: Clicking the Danger Zone row expands the panel to reveal the “Delete” button.
  • Delete: Opens the “Delete Organization” confirmation dialog. You must manually type the organization name into the “Type [Name] to confirm” field, then click “Delete Organization”.

​
Data shown

The organization name, creation date, and your role badge pull from the active workspace profile. The SCIM and SSO configurations are pulled directly from your organization’s configured identity provider settings. The dropdown for SSO roles dynamically populates with standard system roles and any custom roles your organization has created.

​
Common workflows

1. Renaming the organization
  1. Click Edit in the top right of the Organization Details card.
  2. In the dialog, type the new name into the “Organization Name” field.
  3. Click Save.
  4. A success message appears and the new name updates immediately.
2. Setting up SCIM provisioning
  1. Locate the SCIM provisioning card (only visible if SSO is configured).
  2. Click Generate SCIM token.
  3. Enter an optional label (e.g., “Okta production”) and click Generate token.
  4. Click the displayed token to copy it to your clipboard. Click Done.
  5. Click How to set up SCIM in your identity provider to expand the panel and follow the instructions to complete the setup in your system.
3. Rotating an existing SCIM token
  1. In the SCIM provisioning card, click Rotate SCIM token.
  2. Note the warning that the old token will be immediately revoked.
  3. Click Rotate token.
  4. Copy your new token and update it in your identity provider.
4. Deleting the organization
  1. Scroll to the bottom and click the Danger Zone header to expand it.
  2. Click Delete next to “Delete Organization”.
  3. Type the exact organization name into the confirmation box.
  4. Click the red Delete Organization button.
  5. You will be redirected to the home page.

​
Empty, loading, and error states

  • Loading: An animated spinner appears in the center of the page while the workspace data is initially fetching.
  • Empty: If no active organization can be resolved, the page renders blank. If SCIM is not set up, the token status badge will read “Not configured”.
  • Errors: Attempting to save a name, rotate a token, or delete the org will surface a red error toast (e.g., “Failed to update organization name”) if the action fails. The SCIM token status may briefly display “Loading…” if the connection is slow.
  • Linked from: The Settings sidebar navigation (the “General” tab).
  • Links to: The quick links navigate to /settings/users, /settings/domains, /settings/billing, and /settings/activity. A successful organization deletion links back to the root application home page.

​
Common support questions

Why can’t I edit the organization name? The “Edit” button requires specific organization management permissions. If the button is greyed out, you can hover over it to see what you are missing. You will need to ask an administrator to grant you access. Why is the SSO default role dropdown disabled for me? Only organization administrators and owners can change the SSO default role. Because this setting automatically grants access to every new person who joins via SSO, it is strictly protected. Hovering over the disabled dropdown will display the tooltip: “Only org admins can change the SSO default role, since it grants that role to every new SSO member.” Why don’t I see the SSO or SCIM sections at all? These sections are entirely hidden unless your organization has an active Single Sign-On (SSO) integration set up. If you are interested in SSO, please contact support or your account manager. I lost my SCIM token, can I see it again? No. For security reasons, SCIM tokens are only displayed once immediately after they are generated. If you lose the token, you must click “Rotate SCIM token” to generate a new one (which will instantly revoke the old token). Why is the Danger Zone Delete button disabled? Only the absolute owner of the organization can permanently delete the workspace. Hovering over the button will display the tooltip: “Only the organization owner can delete the organization.” Regular administrators cannot perform this action.