beel_get_my_identity
Retrieve the authenticated principal's account ID, email, name, logo, language, and credential details to confirm which account a BeeL credential belongs to and whether it is valid.
Instructions
Returns the identity of the authenticated principal: the account the credential belongs to,
the person's email, name, logo and interface language, and a description of the credential
itself. Unlike every other operation, it requires no scope — any valid credential
resolves, so a 200 confirms the credential works and tells you which account it belongs
to, and a 401 that it does not.
account_id: identifies who the credential belongs to, not what it is currently pointed at; selecting a different company withBeeL-Active-Companydoes not change it.name: resolves astrade_name ?? legal_nameof the active fiscal profile, and isnulluntil onboarding creates one.credential: describes the credential the call was authenticated with — its type, the environment it operates on and the permissions it holds — so a client can adapt what it offers instead of discovering the limits through a403.Caching: responses are never cached (
Cache-Control: no-store).
BeeL API endpoint: GET /v1/me/identity (reference: https://docs.beel.es)
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "beel_get_my_identity"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||