> For the complete documentation index, see [llms.txt](https://docs.tonic.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tonic.ai/app/managing-your-tonic-account.md).

# Managing your user account

From the **User Settings** view, you can manage settings for your individual Tonic Structural account.

To display the **User Settings** view:

1. Click your user image at the bottom of the navigation panel.
2. In the menu, click **User Settings**.

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2FMsRb79OwXNqDu6cOa42d%2FUserMenu.png?alt=media&amp;token=b4c9473e-c12d-44f2-be58-5216da760a32" alt=""><figcaption><p>User menu with the User Settings option</p></figcaption></figure>

The **User Settings** view includes options to:

* [Configure your user image.](#user-settings-user-image)
* [View and copy your organization identifier.](#user-view-copy-org-id)
* [Configure email notifications for column comments.](#user-settings-notifications)
* [Generate and manage API tokens.](#user-settings-api-tokens)
* [Change your Structural password](#user-settings-change-password) (if your Structural organization or instance does not use SSO).
* [Delete your Structural account.](#user-settings-delete-account)

## Choosing your user image <a href="#user-settings-user-image" id="user-settings-user-image"></a>

You can select an image to associate with your account. The image is displayed next to your name and email address throughout Structural.

If your instance uses Google or Azure single sign-on (SSO) to manage Structural users, then by default your Structural account image is the image from the SSO.

Otherwise, the default image displays your initials.

To change your user image, click **Upload**, then select the image fil&#x65;**.**

## Viewing and copying your organization identifier <a href="#user-view-copy-org-id" id="user-view-copy-org-id"></a>

Below your user image file name is the identifier of the organization that your account belongs to.

To copy the identifier, click the copy icon.

## Configuring notifications for column comments <a href="#user-settings-notifications" id="user-settings-notifications"></a>

{% hint style="info" %}
**Required license:** Professional or Enterprise
{% endhint %}

Structural allows users to provide comments on columns. You can do this from [Privacy Hub](https://docs.tonic.ai/app/generation/privacy-hub.md#privacy-hub-protection-status-column-comments) and [Database View](https://docs.tonic.ai/app/generation/database-view/database-view-column-comment.md).

From the **Comment Notification Settings** section of **User Settings**, you can configure when to receive email notifications for comments.

The available options are:

* **I am an owner, editor, auditor, or am being replied to**\
  \
  This is the default option. You receive email notifications when comments are made on columns in a workspace that you are an owner, editor, or auditor for.\
  \
  You also receive an email notification when someone replies to a comment that you made.
* **I am @ mentioned**\
  \
  You only receive an email notification if someone specifically mentions you in a comment.
* **Never**\
  \
  You never receive email notifications for column comments.

## Generating and managing API tokens <a href="#user-settings-api-tokens" id="user-settings-api-tokens"></a>

Before you can use the Structural API, you must create an API token. From the **User API Tokens** section of the **User Settings** view, you can create and manage API tokens.

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2FRXGfd8h9PeUIxSs1XKUb%2FAPITokensList.png?alt=media&amp;token=9a548e21-3157-471e-afcb-515613b33214" alt=""><figcaption><p>User API Tokens list on the User Settings view</p></figcaption></figure>

### Creating an API token <a href="#api-token-create" id="api-token-create"></a>

To create an API token:

1. Click **Create Token**.
2. On the **Create New Token** dialog, enter a name for the new token.
3. Click **Confirm**.

In the list, the new token displays as clear text. To copy the new token, click the copy icon next to the token.

The new token text and copy icon only display during the current session. After that, Structural masks the token and removes the copy icon.&#x20;

### Revoking an API token <a href="#api-token-revoke" id="api-token-revoke"></a>

To revoke a token, click the **Revoke** option for the token.

## Changing your Structural password <a href="#user-settings-change-password" id="user-settings-change-password"></a>

If your Structural account is not managed using SSO, then from **User Settings**, you can change your Structural password.

If your Structural organization uses SSO to manage users, then your user credentials are managed in the SSO system. You cannot change your user password in Structural.

Under **Password Change**, to change your Structural password:

1. In the **Old Password** field, type your current Structural password.
2. In the **New Password** field, type your new Structural password.
3. In the **Repeat New Password** field, type your new Structural password again.
4. Click **Confirm**.

## Deleting your Structural account <a href="#user-settings-delete-account" id="user-settings-delete-account"></a>

From **User Settings**, you can delete your Structural account. If your organization uses SSO to manage users, then deleting your account only affects your access to Structural.

To delete your Structural account, click **Delete Account**.

When you delete your account, you are logged out of Structural.

Any workspaces that you own are added to the **Workspaces Without an Owner** list. For more information, go to [Managing workspaces that do not have an owner](https://docs.tonic.ai/app/workspace/managing-workspaces/workspaces-no-owner.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.tonic.ai/app/managing-your-tonic-account.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
