--- title: Profile slug: profile description: Learn how to access and manage your profile in Flare. Discover how to view and update personal information, modify preferences, enhance security settings, and generate API keys. docTags: createdAt: 2023-10-02T17:33:50.132Z --- The **Profile** page is where you edit your personal account information and customize your Flare experience. From here you can view and update your personal information, adjust your preferences, and manage certain security settings. To open your **Profile**, click the **Account** menu in the top-right corner, then click **Profile**. ::Image[]{src="https://api.archbee.com/api/optimize/wtmLmyh6YG71yn5qVtkMM/dCgNfNU1A48KmAl8WIhOq_image.png" size="70" width="1580" height="1148" isUploading="false" darkWidth="1580" darkHeight="1148" position="flex-start" showCaption="false"} *** # Details The **Details** section holds your basic account information, including your name, email address, and organization. *** # Preferences The **Preferences** section contains two settings: - **Language**: Choose the display language for the Flare interface. - **Appearance**: Choose your color scheme. Select **Dark Mode**, **Light Mode**, or **Sync with system settings**. The **Sync with system settings** option follows your operating system preference and switches automatically when your system theme changes. After updating any field in **Details** or **Preferences**, click **Save changes** to apply them. *** # Security The **Security** section shows the sign-in method configured for your account. When Single Sign-On (SSO) is **Enabled**, you sign in through the configured SSO provider, and your password and multi-factor authentication (MFA) are managed there rather than in Flare. *** # API Keys API keys authenticate your requests when working with the Flare API. You can create, scope, and manage your keys from the **API Keys** section of your **Profile** page. ![](https://api.archbee.com/api/optimize/wtmLmyh6YG71yn5qVtkMM/JA6COCFwXg2mOKnsPbKOs_api-keys.png) Each key in the list shows: - **Name**: The name of the key. - **Status**: Whether the key is currently active or disabled. - **Secret**: A masked preview of the key's secret, shown in full only once at creation. - **Permissions**: The key's scope, either **Default** or the specific permissions assigned. - **Created At**: The date the key was created. - **Last Used**: The last time the key authenticated, updated hourly, or **Never** if unused. - **Expires**: The key's expiration date, or **Never** if none is set. :::hint{type="info"} **Tip: **Hover over the dates to see the exact timestamps. ::: ## Creating an API Key Follow these steps to create a new API Key: :::::WorkflowBlock :::WorkflowBlockItem In the **API keys** section, click **Generate key**. ::: :::WorkflowBlockItem Enter a **Name** to identify the key. ::Image[]{src="https://api.archbee.com/api/optimize/wtmLmyh6YG71yn5qVtkMM/VvfdfgG-E3rq8AieSmH2T_image.png" size="60" isUploading="false" width="808" height="572" darkWidth="808" darkHeight="572" position="flex-start" showCaption="false"} ::: ::::WorkflowBlockItem Under **Permissions**, choose how the key is scoped: - **Default**: The key inherits your current role permissions. - **Restricted**: The key is limited to the specific permissions you select. A key set to Restricted must have at least one permission selected. **Read** or **Write** access can be selected for the following permissions levels: - **All:** Provides unrestricted access to all endpoints. - **Organization: **Provides access to organization-wide actions. For example, [Create Organization Member](https://api.docs.flare.io/api-reference/v2/endpoints/organizations/post-fireworkv2organizations-members), [Retrieve Tenant](https://api.docs.flare.io/api-reference/v2/endpoints/tenants/get-fireworkv2tenants), etc. - **Organization Admin:** Provides access to manage the organization. For example, [List Organization Tenants](https://api.docs.flare.io/api-reference/v2/endpoints/organizations/get-fireworkv2organizations-tenants), [Create Organization Tenant](https://api.docs.flare.io/api-reference/v2/endpoints/organizations/post-fireworkv2organizations-tenants), etc. - **Tenant:** Provides access to data within a Tenant. For example, [List Identifiers](https://api.docs.flare.io/api-reference/v4/endpoints/list-identifiers), [Create Identifier Alert](https://api.docs.flare.io/api-reference/v2/endpoints/identifiers/post-fireworkv2assets-alerts), etc. - **Tenant Admin:** Provides access to manage a Tenant. For example, [List Tenant Memberships](https://api.docs.flare.io/api-reference/v2/endpoints/tenants/get-fireworkv2tenants-users), [Create Tenant Membership](https://api.docs.flare.io/api-reference/v2/endpoints/tenants/post-fireworkv2tenants-users), etc. ::Image[]{src="https://api.archbee.com/api/optimize/wtmLmyh6YG71yn5qVtkMM/NF-8YFJgF_CyYV1qU3nyc_api-key-restrictions.png" size="60" isUploading="false" position="flex-start" width="848" height="774" darkWidth="848" darkHeight="774" showCaption="false" indent="1"} :::hint{type="info"} **Choosing Permissions for a Restricted Key** Permissions required for each endpoint are available in the [API documentation](https://api.docs.flare.io/api-reference/v2/endpoints/). To scope a Restricted key, check the permissions required by the endpoints you are using and then assign them to the key. ::Image[]{src="https://api.archbee.com/api/optimize/wtmLmyh6YG71yn5qVtkMM/P9gHSW9H4oXszvT-kr1VU_image.png" size="50" isUploading="false" width="1070" height="468" darkWidth="1070" darkHeight="468" position="flex-start" showCaption="false"} ::: :::: :::WorkflowBlockItem To set an expiration, choose a date in **Expiration date** setting. The key expires at midnight local time on the date you select. If you leave this field empty, the key never expires. Setting an expiration is recommended but optional. ::: ::::WorkflowBlockItem Click **Create key**. In the **API Key Generated** dialog, click the copy icon to copy the **Secret** and store it somewhere secure, such as a password manager. ::Image[]{src="https://api.archbee.com/api/optimize/wtmLmyh6YG71yn5qVtkMM/5oamMerUK2az3wDKLH2_o_secret-for-api-keys.png" size="50" isUploading="false" position="flex-start" width="826" height="416" darkWidth="826" darkHeight="416" showCaption="false"} :::hint{type="warning"} The secret is shown only once, when the key is first created. It cannot be viewed again afterward. If you lose the Secret for an API key, delete the key and create a new one. ::: :::: ::::: ## Managing an API Key You can perform the following action on an API key after it has been created: ![](https://api.archbee.com/api/optimize/wtmLmyh6YG71yn5qVtkMM/WIAyOvJT9rHjmLrBw7EZ5_image.png) - **Disable a Key**: Disabling a key stops it from authenticating requests. A disabled key can be re-enabled later - **Delete a Key**: Deleting a key permanently removes it. Any workflow or integration using the key loses access. This action is irreversible so proceed with caution. - **Edit a Key**: Click an existing key to change Permissions or the Expiration date. :::hint{type="info"} **API Keys for Deleted Users** When a user is deleted, all API keys they own are also deleted and can no longer be used. ::: *** # Tenants The **Tenants** section shows details about the Tenants you currently have access to. From here you can also select your **Default Tenant**, which is the Tenant that opens automatically when you first log in to Flare. *** # Related Articles :::CtaButton{label="Authentication and Single Sign-On (SSO)" docId="38ubpe5wKfAJ6GQSiH1hc" openInNewTab="true"} ::: :::CtaButton{label="Roles & Permissions" docId="GoTTeRdEAz84wX9s96nzu" openInNewTab="true"} :::