list_members
Read-only
List a workspace’s members as flat rows — userId, display name, role, license, joined date, per-member overage limit, and current-period usage cost in marked-up micro-dollars (1,000,000 = $1, the rate users pay). Chartable as-is. Requires workspace admin.
list_invitations
Read-only
List a workspace’s pending invitations — email, role to be granted, who invited them, created and expiry dates, and whether the invitation has expired. Requires workspace admin.
invite_member
Additive write · Idempotent
Invite someone to a workspace by email, at role admin or member. Sends the invitation email; inviting an already-invited email resends it (one pending invitation per email). Invitations expire after 7 days. Not available on personal workspaces. Requires workspace admin.
revoke_invitation
Destructive write
Revoke a pending workspace invitation by email — it can no longer be accepted. Requires workspace admin.
set_member_role
Destructive write
Change a member’s workspace role (admin | member). The workspace’s only admin cannot be demoted — promote someone else first. Requires workspace admin.
remove_member
Destructive write
Remove a member from a workspace. They lose access immediately; content they created stays. The workspace’s only admin cannot be removed. Not available on personal workspaces. Requires workspace admin.
get_workspace_usage
Read-only
Workspace credit usage as flat, chartable rows: per-period totals, per-member and per-source breakdowns, and a per-member-per-source cross-tab (byMemberSource), in marked-up micro-dollars (1,000,000 = $1, the rate users pay). The cross-tab covers periods from 2026-09-02 on; older periods return the two flat breakdowns only. periods (default 1, max 12) walks back from the current billing period; periods with no recorded usage return zero rows. Requires workspace admin.
set_member_limit
Destructive write
Set a member’s per-period overage limit in micro-dollars (1,000,000 = $1): null inherits the workspace default, 0 hard-blocks at their license allowance, a positive value caps overage spend from the workspace pool, -1 removes the per-member cap (the pool balance stays the hard bound). Requires workspace admin.
set_workspace_limits
Destructive write
Set the workspace’s default per-member overage limit in micro-dollars (1,000,000 = $1) — inherited by every member without an explicit per-member limit. Requires workspace admin.
update_workspace
Destructive write
Rename a workspace, or set its default THEME — the palette and formatting defaults every dashboard in the workspace inherits. Pass name, theme, or both. theme is SPARSE and merges per key: sending {palette:{positive:‘#0f766e’}} changes only that slot and leaves the rest of the stored theme alone, and anything still unset falls through to the Vistazo product default. palette.series (3–12 #rrggbb colours) replaces wholesale — a categorical palette is a set, not per-index edits. formatting carries locale (BCP-47; leave it unset so each viewer sees their own locale), currency (ISO code), dateStyle (short | medium | long), and decimals. Theme values are DEFAULTS — a widget config that names its own currency or colour still wins. Slug and billing fields are not editable here. Requires workspace admin.
list_audit_log
Read-only
List the workspace’s admin audit trail, most recent first: who ran which admin tool, on what target, with what arguments, and when. Covers ADMIN-PLANE actions only (membership, roles, invitations, limits, workspace settings) — dashboard/widget content changes are NOT recorded here; a dashboard’s change history is list_dashboard_versions. Requires workspace admin.