# whoami

Who am I

## Beschreibung

Returns your own identity and the account you act in. Call this
FIRST in a session: every account-scoped tool requires an
`account_id`, and this is where you get it — never invent or guess
one.

When you belong to exactly one account, `account_id` is that
account and you can pass it to every other tool as-is. When you
belong to several, `account_id` is null and you must choose from
`accounts` (a channel or task you were asked about belongs to
exactly one of them).

No parameters. Read-only; safe to call at any time.

## Zugriff

Zugriffsprofil: `basic`. Module: `none`.
Die Freigabe im Profil ersetzt keine Account-, Workspace- oder Rollenberechtigung.

## Parameter

Dieses Tool benötigt keine Parameter.

## Eingabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {},
  "type": "object"
}
```

## Ausgabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "current_user": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "User prefix ID (user_…)."
        },
        "handle": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "is_agent": {
          "type": "boolean",
          "description": "True when you are a bot identity."
        },
        "db_id": {
          "type": "integer",
          "description": "Integer PK — matches user.db_id in chat / time-clock / standup rows."
        }
      },
      "required": [
        "id",
        "handle",
        "name",
        "is_agent",
        "db_id"
      ]
    },
    "account_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "The account to pass as account_id — set when you belong to exactly one, null when you must choose."
    },
    "accounts": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Account prefix ID (acct_…)."
          },
          "name": {
            "type": "string"
          },
          "personal": {
            "type": "boolean"
          },
          "roles": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "admin",
                "employer"
              ]
            },
            "description": "Empty array = regular member."
          }
        },
        "required": [
          "id",
          "name",
          "personal",
          "roles"
        ]
      }
    }
  },
  "required": [
    "current_user",
    "account_id",
    "accounts"
  ],
  "type": "object"
}
```