Your account #
On this page
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). You can see the same account in a browser at https://turnzero.ai/dashboard (step 3).
What your AI tool does #
- Calls
read_accountto 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 itsconnectionsrows, then callsrevoke_tokenwith the chosen row'sidinconnection. - 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).
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.
{
"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 }
}
}
identitieslists each way the account signs in: the sign-in provider, and the user ID that provider verified (subject). Identities and passkeys shows how to add one.profileslists 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.
addressis an email address that one of the identities verified, or null where none has one.grantslists the grants of the credential your AI tool used; it is empty on a customer's account.signed_in_atis the time you signed in, under a browser session. It is null under the tool's connection.address,grants,signed_in_at, andpasskeysdepend on the credential. Under this computer's token, the oneturnzero loginkeeps, the answer containsaddressand none of the other three.- Under any other minted token, and under an application's platform credential, the answer contains none of those four.
passkeyscounts your passkeys that work on this host (held) and the ones registered for another host (stranded). It is null where passkeys are not offered.syntheticmarks platform test accounts.unbilledis set by platform staff, as described below.- Platform staff set
unbilledon the company's own accounts and on complimentary ones. Those accounts are never charged. The per-account 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 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. 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). 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). 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 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 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 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 covers signing in, the emailed code, and removing the connection.
- Identities and passkeys links a second sign-in and manages passkeys.
- Export or delete your account exports the account's declarations and deletes the account.
- Size and usage changes an application's size, reads its usage and lists its refusals.
- Sign-in, sessions, and tokens compares every credential, how long it lasts, and what ends it.
- Glossary defines the terms used on this page.
- read_account, list_tokens, and revoke_token in the generated reference give each action's arguments, result, and refusals.