Identity and workspaces
Who the agent is acting as, and the workspaces it may reach.
Contents
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 |
Current user and workspaces | Read-only |
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.