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

# Workspace settings

The **Settings** page lets you manage your profile, connect external accounts, rename your workspace, and control who has access.

## Connected accounts

The **Connected accounts** card lets you link your Google account so you can sign in with Google in addition to (or instead of) your email and password.

### Connecting Google

1. Go to **Settings** in the sidebar.
2. In the **Connected accounts** card, click **Connect Google**.
3. Complete the Google sign-in flow. You are redirected back to Settings when done.

### Disconnecting Google

Click **Disconnect** next to Google in the **Connected accounts** card.

> **Note:** You can only disconnect Google if your account has a password set. This prevents being locked out of your account. If you signed up with Google and have no password, use the "Forgot password" flow on the login page to set one first.

## Two-factor authentication (2FA)

Protect email/password sign-in with a time-based code from an authenticator app (Google Authenticator, 1Password, Authy, etc.).

1. Go to **Settings → Account**.
2. In the **Two-factor authentication** card, click **Set up authenticator app**.
3. Scan the QR code with your authenticator app (or enter the setup key manually), then enter the 6-digit code and click **Enable 2FA**.

On your next email/password login, enter your password first, then the code from your authenticator app.

> **Note:** 2FA applies to email/password sign-in only. Google sign-in is unchanged. You need a password on your account before you can enable 2FA.

To turn 2FA off, enter your current authenticator code and your account password (if set), then click **Disable 2FA**.

***

## Renaming your workspace

1. Go to **Settings** in the sidebar.
2. In the **Workspace** card, edit the **Workspace name** field.
3. Click **Save**.

Only workspace owners can rename the workspace. Members see the name as read-only.

## Trusted agent issuers

The **Workspace** tab also lists **Trusted agent issuers** — identity providers whose signed ID-JAG assertions may register agents against this workspace's servers with [agent auth discovery](/guides/agent-auth-discovery.md) enabled. Add an issuer with a display name, its issuer URL, and its JWKS URL (both `https`); remove one at any time to stop accepting its assertions. While the list is empty, only the user-claimed flow ([Claim an agent](/guides/claim-an-agent.md)) is advertised to agents.

## Managing workspaces

You can belong to multiple workspaces. Use the workspace switcher at the top of the sidebar to see all workspaces, switch between them, or create a new one.

### Switching workspaces

Click the workspace name at the top of the sidebar, then select the workspace you want to switch to. The page reloads with the selected workspace active and all apps, tools, and settings scoped to that workspace.

### Creating a workspace

1. Click the workspace name at the top of the sidebar.
2. Click **Create workspace** at the bottom of the dropdown.
3. Enter a name and click **Create workspace**.

After creation you are automatically switched to the new workspace.

## Managing members

Use the **Workspace members** card on the Settings page to invite teammates, change their roles, or remove them.

* Only owners can add, remove, or change the role of other members.
* At least one owner must remain in every workspace.
* You can invite someone who does not have a FlowCP account yet. They appear as **Pending** until they sign up using the link in their invitation email.
* Pending invitations can be cancelled with **Cancel invite** before the invitee accepts.

### Inviting someone new to FlowCP

1. Go to **Settings → Members**.
2. Enter their email address and click **Add member**.
3. They receive an email with a **Create account** link.
4. After signup, they join your workspace directly — no separate workspace is created for them.

For details see [Connect your API](/guides/connect-your-api.md) to learn about sharing a workspace with your team after it is set up.
