# Identity and workspaces ## Tools Every other tool takes an explicit `workspaceId` — it is never inferred from context. Start here to resolve one. | Tool | What it does | | |---|---|---| | [`get_me`](#get_me) | Current user and workspaces | Read-only | | [`list_workspace_members`](#list_workspace_members) | List workspace members | Read-only | ## get_me `Read-only` Return the authenticated Vistazo user and the workspaces they belong to — call it first: every core tool takes one of these workspaceIds explicitly, never an assumed one; a source tool or a dataset tool may omit it when exactly one reachable workspace has the tool. Each `workspaces` row carries workspaceId and name, plus slug and role. reachable: false means this connection was not granted that workspace and every call naming it is refused, so pass only reachable ones. closing: true means the workspace is being deleted, and every call naming it is refused the same way. guest: true marks a workspace that is NOT one of the user's workspaces — someone there shared individual objects with them. Only those shared objects are reachable in it (a search there returns just them), no dashboard, skill, notebook or visualization can be created in it, and its name must never be presented as one of the user's workspaces; name the shared object instead. ## list_workspace_members `Read-only` List the people in a workspace: `userId` (the uid every member filter takes), `name`, `role` (admin | member), `seat` (their license — builder = can author, viewer = read-only), and `guest` (share-by-email access to only the dashboards, chats, skills and notebooks shared with them). This is the NAME → UID lookup: when the user talks about a colleague ("what does Priya own?"), resolve the name here, then pass the uid to list_dashboards' `ownerId` / `accessibleBy` or list_skills' `ownerId`. Any full workspace member may list; a guest sees only themselves. An ADMIN of the workspace (outside the built-in assistant, whose transcripts are shareable) also gets `periodKey` and, per member, `license`, `joinedAt`, `overageLimitMicros` (null = inherits the workspace default) and `periodCostMicros` — current-period usage in marked-up micro-dollars (1,000,000 = $1, the rate users pay); chartable as-is. `includeInvitations` adds the pending invitations. ### `includeInvitations` true adds the workspace's pending invitations — email, role to be granted, who invited them, created and expiry dates, and whether each has expired. Requires workspace admin; anyone else gets the members with a note in place of the invitations.