---
title: Your account
description: See which account your AI tool acts for, how it signs in, which products it holds, whether it is active or suspended, and what the dashboard shows.
slug: /guides/your-account
order: 32
visibility: public
redirects_from: []
---

# Your account

Prompt:

> Which account is this tool signed in as?

Also works:

- "Is my account in good standing?"
- "Which products does my account have?"
- "Where can I see my applications in a browser?"
- "End the connection on my old laptop."

Your AI tool calls `read_account` to see which account its connection acts for. The answer lists the account's sign-ins and its standing, active or suspended ([step 1](#1-read-the-account)). You can see the same account in a browser at `https://turnzero.ai/dashboard` ([step 3](#3-use-the-signed-in-site)).

## What your AI tool does

- Calls `read_account` to confirm which account the connection acts for, and reports its identities, its standing, and its products.
- Gives you the signed-in site's address, `https://turnzero.ai/dashboard`, when you want to see the account in a browser.
- To end one tool's connection, calls `list_tokens`, reads its `connections` rows, then calls `revoke_token` with the chosen row's `id` in `connection`.
- Asks you nothing and writes nothing into your project. It changes nothing on your account unless you ask it to end a connection.

## Before your AI starts

**For the AI tool:** Check the following before starting.

- A connected, signed-in AI tool ([Connect your AI assistant](/cloud/getting-started/connect-your-tool/)).

## Steps

### 1. Read the account

`read_account` takes no arguments and returns the connected account. Here are selected fields from an answer under a tool’s connection, for an account that signs in with GitHub.

```json
{
  "contract_version": 1,
  "reference": "0a1b2c3d4e",
  "account": {
    "id": "11111111-2222-4333-8444-555555555555",
    "created_at": "2026-09-14T08:00:00.000Z",
    "standing": "active",
    "identities": [{ "provider": "github", "subject": "4802" }],
    "profiles": [{ "product": "tzcloud" }, { "product": "tzmesh" }, { "product": "tztrack" }],
    "synthetic": false,
    "unbilled": false,
    "address": "ana@example.com",
    "grants": [],
    "signed_in_at": null,
    "passkeys": { "held": 1, "stranded": 0 }
  }
}
```

- `identities` lists each way the account signs in: the sign-in provider, and the user ID that provider verified (`subject`). [Identities and passkeys](/cloud/guides/identities-and-passkeys/) shows how to add one.
- `profiles` lists the products your account can use.
- With tzTeam access, the tzTeam pages appear in the site's header after you sign in at turnzero.ai.
- `address` is an email address that one of the identities verified, or null where none has one.
- `grants` lists the grants of the credential your AI tool used; it is empty on a customer's account.
- `signed_in_at` is the time you signed in, under a browser session. It is null under the tool's connection.
- `address`, `grants`, `signed_in_at`, and `passkeys` depend on the credential. Under this computer's token, the one `turnzero login` keeps, the answer contains `address` and none of the other three.
- Under any other minted token, and under an application's platform credential, the answer contains none of those four.
- `passkeys` counts your passkeys that work on this host (`held`) and the ones registered for another host (`stranded`). It is null where passkeys are not offered.
- `synthetic` marks platform test accounts. `unbilled` is set by platform staff, as described below.
- Platform staff set `unbilled` on the company's own accounts and on complimentary ones. Those accounts are never charged. The per-account [limits](/cloud/guides/plan-and-usage/#current-application-limits) on applications and issue spaces do not apply to them.

The product names in `profiles` are:

- `tzcloud`: Turn Zero Cloud, included with every account.
- `tztrack`: Turn Zero Track (tzTrack), the issue database, included with every account.
- `tzmesh`: Turn Zero Mesh (tzMesh), messaging for people and AI agents, included with every account unless the platform makes it invitation-only.
- `tzteam`: Turn Zero Team (tzTeam), available by invitation.

No separate step is needed to add Turn Zero Cloud or tzTrack, or tzMesh while it is open to every account.

Each account belongs to one person, and each application belongs to the account that created it. Organization ownership, team seats, and organization roles are not available.

### 2. Read the standing

The account's `standing` is `active` or `suspended`. Platform staff can suspend and reinstate an account.

A suspension ends the account's sessions, and every action that needs your identity is refused. It also applies to each of Turn Zero's own products you use. Within about a minute, each product's service reads a `suspended` row from this platform. It then refuses your credentials there until a `reinstated` row follows.

While suspended, you can still read the library and the published context, under a token of the account. [Sign-in, sessions, and tokens](/cloud/concepts/sign-in-sessions-and-tokens/#when-an-ending-takes-effect) says how soon a suspension or a reinstatement reaches each part of the platform. After a reinstatement, sign in again.

### 3. Use the signed-in site

`/dashboard` on turnzero.ai is the browser view of your account. Its pages show the address you signed in with. The Account & security page also shows your account's ID, the `id` that `read_account` returns.

- **Applications** shows your applications.
- **Connected AI tools** shows your connected tools and messaging access.
- **Balance & usage** shows the month's balance, account charges, and each application's size and usage.
- **AI prompts** lets you choose an application and copy or edit a prompt for your own AI chat. Copying a prompt runs no action and approves no change.
- Each application on the Applications page shows each of its environments, with the environment's deployed version and state.
- For a deployed application, Applications also shows the last minute in which its production URL passed a request to your code. The request can come from anyone, you included.
- An application's page opens from **Manage app** on Applications. With two environments, use **Environment** below its heading to choose one. Its state, version, live compute state, database and newest deployment follow that choice; **Size** and **Usage this month** cover the application. **Scheduled jobs** appears only where that environment declares schedules. The page also lists storage areas and upstreams, with **Upload a file** beside the storage areas.
- **Secrets** lists names, scopes, and storage and rotation times, never values. Use **Add a secret** to save a new value and **Replace value** beside a row to rotate it. A secret the platform created is marked as managed by the platform and has no replace control.
- **Account & security**, `/dashboard/account`, has **Sign-in & security**, which shows your passkey standing and other sign-in methods and links to the passkey page.
- **Agents & sessions** opens tzMesh’s site.
- **tzMesh preferences** opens tzMesh’s site.

A storage area or upstream not bound to an application does not appear on the dashboard. Use `list_storage_areas` or `list_outbound_apis` to find it.

For a file your AI will include in a deploy, follow [Upload a file from the application's page](/cloud/guides/store-files/#upload-a-file-from-the-application-s-page). If the app has no storage area, your AI declares one first. Give it the file name shown after the upload.

In the application's **Summary**, use **Change size** to choose its size or production's sleep setting ([Size and usage](/cloud/guides/plan-and-usage/)). Its page also offers **Pause app** or **Resume app**, **Upload a file**, a scheduled job's **Run now**, and **Delete app**.

**Delete app** is at the bottom of the application's page, below its sections. It names the application and offers **Review deletion**. Choose it to open the approval page, where you approve the permanent deletion ([Delete the application](/cloud/guides/manage-versions-and-environments/#delete-the-application)). While the deletion runs, the application's page turns **Delete app** off. **Pause app** and **Resume app** are absent.

The Account & security page also has **Sign out everywhere** and the control that requests your account’s deletion. Other management actions are available through your AI tool. When an action waits for your approval, your AI tool prints a link that opens its approval page.

Changes on the site, including file uploads, need a sign-in within the last 8 hours. If it has been longer, follow **Sign in again**, then retry the change.

### 4. Read and end connections

`list_tokens` returns the tools signed in to your account in `connections`, one row per connection. Each row has the connection's `id` and `client_id`, and `client_name` and `client_host`, the name and address host its tool registered, or null. It also has the time of the sign-in that opened it, its last renewal, and its expiry. Its `address` says where the connection was made: `turnzero`, `tzcloud`, or `tztools`.

The address determines which products an MCP connection provides. Your account’s access still applies. [Connect your AI assistant](/cloud/getting-started/connect-your-tool/) gives the address and name for each route.

`revoke_token` with `connection` set to that row's `id` ends one connection. That tool’s access and its renewal are refused at once, and every other connection stays open. The **Connected AI tools** page, `/dashboard/ai-tools`, lists the same rows with a **Disconnect** button on each. Each row shows its id, sign-in, last renewal (or “not yet”) and expiry.

To end every connection and every browser session at once, use **Sign out everywhere** on the Account & security page, or `sign_out_everywhere` from your AI tool. It returns how many sessions it ended. Every device and tool must then sign in again. Your passkeys stay, and so do the tokens you minted with `mint_token`. [What ends a connection](/cloud/concepts/sign-in-sessions-and-tokens/#what-ends-a-connection) lists what else it ends. **Sign out** in the dashboard menu ends that browser's session alone.

If the response is `internal` and says a token made during the sign-out may still be valid, sign in again. Then run **Sign out everywhere** once more.

## Expected result

`read_account` returns the account as step 1 shows, with `standing` `active` on an account in good standing. `list_tokens` includes your AI tool's own connection in `connections`. After `revoke_token` ends it through `connection`, that row is gone and its tool must sign in again.

## Refusals

See the [refusals reference](/cloud/reference/refusals/) for other platform errors.

| Refusal | Status | Cause | Remedy |
| --- | --- | --- | --- |
| `authentication_required` | 401 | No credential matched an account. `read_account` returns it for a session with no account. | Sign in again through your AI tool. |
| `account_suspended` | 403 | The account is suspended, so sign-ins and the actions that need your identity are refused. | Wait for platform staff to reinstate the account, then sign in again. |
| `fresh_authentication_required` | 403 | A change from the dashboard came more than 8 hours after your browser sign-in. | Follow the page's Sign in again link, then repeat the change. |
| `not_found` | 404 | `revoke_token` with `connection` named no live connection of your account. | Call `list_tokens` and pass a `connections` row's `id` in `connection`. |
| `cloud_required` | 403 | The platform refused the call's Turn Zero Cloud access check. | Every account includes Turn Zero Cloud. Call `read_account` to confirm the account, then repeat the request. |

## Related

- [Connect your AI assistant](/cloud/getting-started/connect-your-tool/) covers signing in, the emailed code, and removing the connection.
- [Identities and passkeys](/cloud/guides/identities-and-passkeys/) links a second sign-in and manages passkeys.
- [Export or delete your account](/cloud/guides/export-or-delete-your-account/) exports the account's declarations and deletes the account.
- [Size and usage](/cloud/guides/plan-and-usage/) changes an application's size, reads its usage and lists its refusals.
- [Sign-in, sessions, and tokens](/cloud/concepts/sign-in-sessions-and-tokens/) compares every credential, how long it lasts, and what ends it.
- [Glossary](/cloud/concepts/glossary/) defines the terms used on this page.
- [read_account](/cloud/reference/actions/read-account/), [list_tokens](/cloud/reference/actions/list-tokens/), and [revoke_token](/cloud/reference/actions/revoke-token/) in the generated reference give each action's arguments, result, and refusals.
