List all workbooks in the organization. Pass summary_only=True for concise token-efficient response.

Get workbook metadata.

Create an empty workbook in a folder.

Duplicate an existing workbook.

workbook_id: ID of the workbook to clone. name: Name for the new cloned workbook (required by the API). destination_folder_id: ID of the destination folder. If omitted, clones into the same folder as the original.

List pages in a workbook.

List data lineage for a workbook.

Get version history for a workbook.

Restore a workbook to a previous version.

Convert a workbook to a report (one-way, creates a new report).

workbook_id: ID of the workbook to convert. name: Name for the new report (required by the API). destination_folder_id: Optional folder ID for the report; defaults to My Documents.

List permission grants on a workbook.

Grant access to a workbook. grant_type: 'member' or 'team'. permission: 'view', 'explore', 'edit'.

List embed configurations for a workbook.

Create an embed for a workbook.

embed_type: Visibility of the embed. Only 'public' is currently supported. source_type: Scope of the embed — 'workbook' (entire workbook), 'page', or 'element'. source_id: Required when source_type is 'page' or 'element'.

Export a workbook element. If element_id is empty, exports the first page.

format: 'pdf', 'png', 'csv', 'xlsx', 'json', 'jsonl'. layout: 'portrait' or 'landscape' (only for pdf/png). element_id: The specific element to export. If omitted, uses the first page element.

List scheduled exports for a workbook.

Create a scheduled export for a workbook. See Sigma docs for schedule body schema.

Delete a scheduled export. Requires confirm=True.

List bookmarks (saved filter states) in a workbook.

Add a bookmark to a workbook.

List tags on a workbook.

Apply a version tag to a workbook by tag NAME (e.g. 'Production'). The Sigma API takes the tag name here, not its ID.

Remove a tag from a workbook. Requires confirm=True.

List all templates in the organization.

Get template details.

Create a workbook from a template. This brings real visuals — the only programmatic way to get charts/tables.

Save a workbook as a reusable template.

List all reports in the organization.

Get report metadata.

Create a report.

Duplicate a report.

report_id: ID of the report to clone. name: Name for the new cloned report (required by the API). destination_folder_id: ID of the destination folder to clone into (required by the API).

List data sources used by a report.

List elements in a report.

List SQL queries in a report.

List lineage for a report.

Export a report. format: 'pdf', 'png', 'csv', 'xlsx'.

List scheduled exports for a report.

Create a scheduled export for a report.

List templates shared with your organization from other orgs.

Accept a pending template share from another organization.

Copy a workbook into a member's My Documents folder.

name: Optional name for the copied workbook. Defaults to the original workbook name.

Full deployment: instantiate a template into a folder, then optionally swap its sources.

Promote a workbook by tagging it (e.g., 'Production'). Creates tag if it doesn't exist.

Export a workbook/element and download the result. Polls until ready.

format: 'csv', 'pdf', 'xlsx', 'png'. layout: 'portrait' or 'landscape' (pdf only). parameters: Sigma control overrides e.g. {'DateRange': 'min:2024-01-01,max:2024-01-31'}. max_bytes: maximum allowed response size (default 10 MB). Returns size info without content if exceeded. Returns base64-encoded file content on success.

Transfer all workbooks from one member to another.

Resolves members by email, finds all workbooks owned by old owner, then PATCHes /v2/files/{id} to reassign. dry_run=True (default) reports what would change without making changes.

List all workbooks accessible to a member with full workbook metadata.

Cross-references member's file list against the full workbook catalog.

List ALL workbooks in the organization, automatically following pagination.

List ALL reports in the organization, automatically following pagination.

Update a workbook from a code representation (JSON document specification).

Mutating operation. Requires confirm=True and document_version integer to guard against concurrent overwrites.

Verify a workbook code representation specification without saving.

Validates schema structure, syntax, and element layout.

Update a report from a code representation (JSON document specification).

Mutating operation. Requires confirm=True and document_version integer to guard against concurrent overwrites.

Verify a report code representation specification without saving.

Download an exported query result file by queryId.

Returns the file content (JSON or text/CSV) or base64 binary (PDF, XLSX, PNG), or reports 'processing' if the query has not finished executing. max_bytes: Maximum allowed payload size in bytes (default 10 MB).

List AI agents defined in a specific workbook (optionally filtering by version tag).

Run an in-workbook AI agent with conversation messages.

Mutating / execution operation. Consumes LLM tokens. Requires confirm=True. messages: List of conversation turns (role: 'user', 'assistant', 'system', 'tool' with content). version_tag_name: Target published version tag (defaults to latest published version).

List all connections in the Sigma organization. Pass summary_only=True for concise token-efficient response.

Get details for a specific connection.

Force Sigma to re-index a warehouse path. Pass empty list for full sync.

Test connectivity for a connection.

List columns for a warehouse table by its tableId.

List permission grants on a connection.

Add a grant to a connection.

grant_type: 'member' or 'team'. permission: 'annotate' (Can Use & Annotate) or 'usage' (Can Use).

Delete a grant from a connection path. DESTRUCTIVE. Requires confirm=True.

List all data models in the organization. Pass summary_only=True for concise token-efficient response.

Get data model metadata.

Get the full code representation (JSON spec) of a data model — tables, columns, metrics, relationships.

Create a data model from a JSON code representation. Must include name, folderId, schemaVersion, and pages with elements.

Update an existing data model from a JSON code representation (full replacement via PUT).

List elements in a data model.

List all columns across all elements in a data model.

Swap data sources for a data model.

List lineage for a data model.

Apply a version tag to a data model by tag NAME. The Sigma API takes the tag name here, not its ID.

Swap data sources on a report. Use connectionMapping for connection-level swaps, sourceMapping for table-level swaps.

Sync all tables in a warehouse schema so they become visible in Sigma.

Sync connections across all tenant organizations.

Lists all tenants, then for each tenant: obtains a tenant-scoped token, lists their connections, and syncs each one. Requires multi-tenant auth (for_tenant method). Uses bounded concurrency.

NOTE: Requires PyJWT and the for_tenant() method (Phase C). Returns an error if token exchange is not available.

List ALL data models in the organization, automatically following pagination.

List elements on a specific page of a workbook.

List all elements (tables, charts, controls, etc.) in a workbook.

List all columns across all elements in a workbook, including formulas and types.

List generated SQL queries for all elements in a workbook.

List control elements (filters, parameters) in a workbook.

List data sources used by a workbook.

Swap data sources for a workbook. Use connectionMapping for connection-level swaps, sourceMapping for table-level swaps.

Get the generated SQL query for a specific element in a workbook.

List columns for a specific element in a workbook.

Trigger materialization for a workbook. Pass elementId in body if needed.

Check status of a materialization job.

List materialization schedules for a workbook.

Swap data sources on a template. Use connectionMapping for connection-level swaps, sourceMapping for table-level swaps.

List all source swap policies (rules for automatic source swapping on deployment).

Get a source swap policy.

Create a source swap policy for automated deployments.

Trigger materialization and poll until complete or timeout.

Scan all workbooks to find input-table elements.

Returns a list of input tables with their workbook, page, and element context. Errors on individual workbooks/pages are collected rather than silently swallowed.

Return a curated reference of common Sigma formula pitfalls — column reference syntax, type requirements, NULL handling, aggregate vs row-level context, date function argument order, and metrics vs calculated columns. Use this before writing any Sigma formula expression.

Search Sigma Computing documentation using AI-powered semantic search. Returns relevant doc passages with source URLs. Use this to answer questions about Sigma features, configuration, formulas, administration, embedding, and best practices.

read_only_hint: True

Fetch a specific Sigma documentation page as clean Markdown. Pass the page slug (e.g. 'create-a-workbook') or a section path (e.g. 'docs/create-a-workbook'). Returns the full page content.

read_only_hint: True

Delete a file/workbook/data model by its inode ID. Requires confirm=True.

List files/folders. Optionally filter by parentId or type ('workbook', 'folder', 'data-model', 'template').

Create a folder.

Update file properties (name, parentId for moving).

List all tags in the organization. Supports pagination via page token.

Create a new tag (used for version promotion like 'Production', 'Staging').

Delete a tag. Requires confirm=True.

List all workspaces. Supports pagination via page token.

Get workspace details.

Create a new workspace.

Delete a workspace. Requires confirm=True.

List permission grants on a workspace. Supports pagination via page token.

Grant workspace access.

grant_type: 'member' or 'team'. permission: 'view', 'explore', 'organize' (Contribute), or 'edit' (Manage).

Delete a permission grant from a workspace. DESTRUCTIVE. Requires confirm=True.

List files/folders in the organization, automatically following pagination.

parent_id: Optional parent folder ID to list files within. type_filter: Optional file type filter ('workbook', 'folder', 'data-model', 'template', 'symlink'). Note: Shortcuts/symlinks are excluded by default unless type_filter='symlink'.

List all deployment policies.

Get a deployment policy.

Create a deployment policy.

Delete (archive) a deployment policy. Requires confirm=True.

Deactivate a member. Requires confirm=True.

List documents in a deployment policy.

Add workbooks/reports to a deployment policy.

List all tenant organizations (for multi-tenant deployments).

Get tenant organization details.

Create a tenant organization.

List all API connectors (custom data integrations).

Get details for an API connector.

List all members in the organization. Pass summary_only=True for concise token-efficient response.

Get member details including homeFolderId.

Create a new member. member_type: 'admin', 'creator', 'viewer'.

Update member properties (firstName, lastName, memberType, isActive, etc.).

Get the current authenticated user's details.

List teams a member belongs to.

List all teams. Pass summary_only=True for concise token-efficient response.

Get team details.

Create a new team.

Delete a team. Requires confirm=True.

List members of a team.

Add or remove members from a team. Provide lists of member IDs.

List all user attributes (used for row-level security and dynamic parameters).

Create a user attribute for RLS or dynamic parameters.

name: Attribute name (e.g. 'Region', 'CustomerID'). default_value: Default string value assigned when no override exists. description: Optional description of the attribute.

Set a user attribute value for specific teams.

assignments: List of objects, each with 'teamId' (str) and 'value' (str). Example: [{"teamId": "abc123", "value": "US"}]

Set a user attribute value for specific tenants.

assignments: List of objects, each with 'tenantOrganizationId' (str) and 'value' (str). Example: [{"tenantOrganizationId": "org123", "value": "US"}]

Get all user assignments for a user attribute.

Get all team assignments for a user attribute.

Get all tenant assignments for a user attribute.

Revoke a user attribute assignment for specific users. Requires confirm=True.

user_ids: List of user IDs whose attribute assignments should be removed. Example: ["user-uuid-1", "user-uuid-2"]

To assign (not revoke), use sigma_set_user_attribute_for_users instead (direct POST to /v2/user-attributes/{id}/users not yet exposed as a dedicated tool — use sigma_create_grant with a raw body as a workaround).

Revoke a user attribute assignment for specific teams. Requires confirm=True.

team_ids: List of team IDs whose attribute assignments should be removed. Example: ["team-uuid-1", "team-uuid-2"]

Revoke a user attribute assignment for specific tenants. Requires confirm=True.

tenant_org_ids: List of tenant organization IDs whose attribute assignments should be removed. Example: ["org-uuid-1", "org-uuid-2"]

Delete a user attribute assignment for a specific user. DESTRUCTIVE. Requires confirm=True.

Delete a user attribute assignment for a specific team. DESTRUCTIVE. Requires confirm=True.

Delete a user attribute assignment for a specific tenant. DESTRUCTIVE. Requires confirm=True.

List all account types (license types) in the organization.

List grants for a specific file/workbook/data model by inodeId. Required: inodeId.

Create or update a grant. Body must include inodeId, granteeId, permission, type.

List organization translation files.

Onboard a new member: create account then add to teams.

Add multiple members to a team in one call.

Deactivate members matching a name pattern (regex on firstName+lastName).

DESTRUCTIVE: requires both dry_run=False AND confirm=True to execute. Default behavior (dry_run=True) reports matches without making changes. Uses ?includeInactive=true to avoid re-deactivating already-inactive members.

Change a member's email address via PATCH /v2/members/{id}.

Remove multiple members from a team by their email addresses.

Resolves emails to member IDs, then sends a single PATCH to remove all. Requires confirm=True.

List all tenants using cursor-based pagination (nextPageToken model).

Unlike offset-based pagination, tenants use cursor tokens. Returns the complete list of all tenant organizations.

Demonstrate tenant token exchange by calling /whoami through a tenant-scoped client.

Uses RFC 8693 token exchange to obtain a tenant-scoped token, then calls the whoami endpoint to verify the scoped identity.

Describe what the Sigma REST API can and cannot do programmatically.

List ALL members in the organization, automatically following pagination.

List ALL teams in the organization, automatically following pagination.

List recently recorded incoming Sigma webhook events.

read_only_hint: True

List all workbook agents across the organization.

Get organization setting value.

Update organization setting value.

Mutating operation. Requires confirm=True. setting_name: One of aiChatHistory, auditLogging, bulkCopy, comments, csvUpload, emailBranding, licenseUpgradeRequests, publicEmbeds, sampleConnections, timezone. setting_value: Dict containing setting fields to update.

Configure the organization AI provider and models.

Mutating operation. Requires confirm=True. provider_config: Provider specification dict (e.g. provider='openAI'/'anthropic'/'gemini'/'snowflake'/'databricks'/'bedrock'/'azureOpenAI').

Reset the organization email branding settings back to defaults.

Destructive operation. Requires confirm=True.

List IP allowlist entries configured for the organization (v3alpha).

Create/add IP allowlist entries for the organization (v3alpha).

Mutating operation. Requires confirm=True. entries: List of dicts, each with 'ip' (IPv4/IPv6 or CIDR), 'scope' ('public-api', 'ui', or 'both'), and optional 'description'.

Delete IP allowlist entries by ID from the organization (v3alpha).

Destructive operation. Requires confirm=True. entry_ids: List of IP allowlist entry ID strings to delete.