mcp-server-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.

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

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').

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.

Copy a workbook into a member's My Documents folder. name: Optional name for the copied workbook. Defaults to the original workbook name.

Create an account type. body requires name, description and permissions.

Create an API connector. body requires name and params and may set description, config and authId.

Create an API credential for API connectors. body requires name, allowlist and credential, and may set description. The credential holds a secret: pass it only from the user's own input.

Create a data warehouse connection. body requires name and details (the warehouse type and its settings) and may set description, poolSizes, timeoutSecs and useFriendlyNames. The details may hold write-only secrets (password, privateKey, privateKeyPassphrase, clientSecret, token, pythonSecrets): pass them only from the user's own input. They are masked wherever Sigma's result or error echoes them.

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

Create a deployment policy.

Create a folder.

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

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

Create a report.

Grant users or teams permission on a report. body requires grants: a list of {grantee: {memberId} or {teamId}, permission: 'view' | 'edit'}.

Create a scheduled export for a report.

Create a source swap policy for automated deployments.

Create a new tag (used for version promotion like 'Production', 'Staging'). color: Tag color, required by the Sigma API. One of: cyan, grass, violet, plum, amber, bronze. Defaults to 'cyan'.

Create a new team.

Create a tenant organization.

Create the organization translation file for a language code. body may set translations (key to translated string) and lng_variant.

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.

Create an empty workbook in a folder.

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'.

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

Create a new workspace.

Deactivate a member. Requires confirm=True.

Delete an account type. Requires confirm=True.

Delete an API connector. Requires confirm=True.

Delete an API credential. Requires confirm=True. API connectors that use it stop authenticating.

Delete a connection. Requires confirm=True. Workbooks and data models built on it lose their source.

Delete a grant from a connection. Requires confirm=True. Retrieve grant IDs with datasets_list_connection_grants.

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

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

Delete a grant by ID. Requires confirm=True.

Delete a grant from a report. Requires confirm=True.

Delete a report's scheduled export. Requires confirm=True.

Delete a template share. Requires confirm=True. Retrieve share IDs with workbooks_list_shared_templates.

Delete a source swap policy (Beta). Requires confirm=True.

Delete a tag. Requires confirm=True.

Delete a team. Requires confirm=True.

Delete a tenant organization. Requires confirm=True.

Delete the organization translation file for a language code. Requires confirm=True.

Delete the organization translation file for a language code and variant. Requires confirm=True.

Delete a user attribute and every assignment of it. 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.

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

Delete a saved view (bookmark) from a workbook. Requires confirm=True.

Delete an embed from a workbook. Requires confirm=True. Retrieve embed IDs with workbooks_list_workbook_embeds. Embeds that use the embed URL stop working.

Delete a grant (a user's or team's permission) from a workbook. Requires confirm=True. Retrieve grant IDs with workbooks_list_workbook_grants.

Delete a scheduled export. Requires confirm=True.

Delete a workspace. Requires confirm=True.

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

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

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).

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).

Duplicate the version of a report carrying a version tag into a folder as a new report. tag_name is the version tag NAME. Returns the new report.

Duplicate the version of a workbook carrying a version tag into a folder as a new workbook. tag_name is the version tag NAME (e.g. 'Production'). copy_bookmarks is "all" (every saved view; admins only) or "accessible" (personal saved views and those shared with the caller); leave it unset to copy none. Returns the new workbook.

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.

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.

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

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.

Add a document to a member's favorites.

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.

Get details for an API connector.

Get an API credential's metadata.

Get details for a specific connection.

Get the current authenticated user's details.

Get data model metadata.

Get the status of a data model materialization job.

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

Get a deployment policy.

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

List columns for a specific element in a workbook. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

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

Get a file's details (type, name, path, owner) by its inode ID.

Get a grant by ID.

Check status of a materialization job.

Get member details including homeFolderId.

Get organization setting value. setting_name: One of aiChatHistory, auditLogging, bulkCopy, comments, csvUpload, emailBranding, licenseUpgradeRequests, publicEmbeds, sampleConnections, timezone.

Get report metadata.

Get the SQL query Sigma generates for a report element.

Get the version history of a report (published versions, who and when). Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read.

Get a source swap policy.

Get team details.

Get template details.

Get tenant organization details.

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.

Get the organization translation file for a language code (e.g. 'fr').

Get the organization translation file for a language code and variant.

Get a user attribute's definition.

Get all team assignments for a user attribute. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

Get all tenant assignments for a user attribute. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

Get all user assignments for a user attribute. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

Get workbook metadata.

List tags on a workbook. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

Get version history for a workbook. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

Get workspace details.

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

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

List all account types (license types) in the organization. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read.

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

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'.

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.

List ALL members in the organization, automatically following pagination.

List ALL reports in the organization, automatically following pagination.

List ALL teams in the organization, automatically following pagination.

List ALL workbooks in the organization, automatically following pagination.

List IP allowlist entries configured for the organization (v3alpha). Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read. ``page_token`` resumes from a ``nextPageToken``; ``page_size`` is the page size.

List all API connectors (custom data integrations). Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read.

List the API credentials API connectors use (metadata only). Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read.

List columns for a warehouse table by its tableId. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read.

List permission grants on a connection. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List grants on a connection path (database, schema or table). Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List connection paths (databases, schemas and tables) across all connections. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List all connections in the Sigma organization. Pass summary_only=True for concise token-efficient response. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List all columns across all elements in a data model. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List elements in a data model. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List lineage for a data model. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List the materialization schedules of a data model. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read.

List the sources (tables, datasets, other data models) a data model reads from. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read.

List the version tags on a data model. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List all data models in the organization. Pass summary_only=True for concise token-efficient response. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read. ``limit`` is the page size.

List the tenant organizations deployments can target. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read.

List documents in a deployment policy. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read.

List the tenants a deployment policy deploys to. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read.

List all deployment policies. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read.

List the lineage (upstream sources and dependencies) of one workbook element.

List a member's favorite documents. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List files/folders. Optionally filter by parentId or type ('workbook', 'folder', 'data-model', 'template'). Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List grants for a specific file/workbook/data model by inodeId. Required: inodeId. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List every materialization schedule for a workbook. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List the files (workbooks, data models, folders) a member can access. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read. ``limit`` is the page size.

List the scheduled exports a member owns. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List teams a member belongs to. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List all members in the organization. Pass summary_only=True for concise token-efficient response. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read. ``limit`` is the page size.

List all workbook agents across the organization. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read. ``page_token`` resumes from a ``nextPageToken``; ``page_size`` is the page size (spec maximum 100, the default).

List the files a member opened recently. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List recently recorded incoming Sigma webhook events. read_only_hint: True

List the columns of every element in a report. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read.

List the controls (filters and parameters) in a report. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read.

List elements in a report. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read.

List lineage for a report. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read.

List the elements on one page of a report. Retrieve page IDs with workbooks_list_report_pages. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read.

List the pages of a report. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read.

List SQL queries in a report. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read.

List scheduled exports for a report. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List data sources used by a report.

List the version tags on a report. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read.

List all reports in the organization. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read. ``limit`` is the page size.

List templates shared with your organization from other orgs. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List all source swap policies (rules for automatic source swapping on deployment). Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List all tags in the organization. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read. ``page`` resumes from a ``nextPage`` cursor; ``limit`` is the page size.

List members of a team. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List all teams. Pass summary_only=True for concise token-efficient response. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read. ``limit`` is the page size.

List all templates in the organization. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read. ``limit`` is the page size.

List which tenant organizations a tenant can deploy to. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read.

List all tenant organizations (for multi-tenant deployments). Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page and ``nextPageToken`` null, since every page is read.

List all tenants, following Sigma's cursor pagination to the last page. ``GET /v2/tenants`` pages with ``pageSize``/``pageToken`` and answers ``nextPageToken`` (not ``limit``/``page``/``nextPage``). Returns ``{"total": N, "tenants": [...]}`` with every tenant organization.

List organization translation files. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List all user attributes (used for row-level security and dynamic parameters). Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List AI agents defined in a specific workbook (optionally filtering by version tag). Returns Sigma's single response. The spec documents no page-token request parameter for this endpoint, so a ``nextPageToken`` in the response cannot be followed.

List bookmarks (saved filter states) in a workbook. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List all columns across all elements in a workbook, including formulas and types. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List control elements (filters, parameters) in a workbook. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List all elements (tables, charts, controls, etc.) in a workbook. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List embed configurations for a workbook. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List permission grants on a workbook. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List data lineage for a workbook. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List elements on a specific page of a workbook. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List pages in a workbook. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List generated SQL queries for all elements in a workbook. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List every scheduled export for a workbook. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List data sources used by a workbook.

List all workbooks in the organization. Pass summary_only=True for concise token-efficient response. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read. ``limit`` is the page size.

List the workbooks carrying a version tag. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read.

List all workbooks accessible to a member with full workbook metadata. Cross-references member's file list against the full workbook catalog.

List permission grants on a workspace. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read. ``page`` resumes from a ``nextPage`` cursor; ``limit`` is the page size.

List all workspaces. Follows Sigma's pagination to the last page and returns the keys of Sigma's page: ``entries`` from every page, ``total`` when Sigma sends it (Sigma's value), and ``nextPage`` null (``hasMore`` false where Sigma sends it) since every page is read. ``page`` resumes from a ``nextPage`` cursor; ``limit`` is the page size.

Look up the object at a fully qualified path in a connection, e.g. ["DATABASE", "SCHEMA", "TABLE"] for Snowflake. Read-only: the POST only resolves the path.

Trigger materialization and poll until complete or timeout.

Run the scheduled materialization for one data model element now. sheet_id is the element's ID. Returns the materialization job; poll it with datasets_get_data_model_materialization.

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

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

Promote a workbook by tagging it (e.g., 'Production'). Creates tag if it doesn't exist. tag_color: Color for newly created tags. One of: cyan, grass, violet, plum, amber, bronze. Ignored if the tag already exists. Defaults to 'cyan'.

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. Both arguments must be email addresses (Sigma looks members up by email only), and each must match exactly one member's email, ignoring case; otherwise the call fails before any change.

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.

Remove a document from a deployment policy. Requires confirm=True.

Remove a tenant from a deployment policy. Requires confirm=True.

Remove a version tag from a report. Requires confirm=True. Retrieve tag IDs with workbooks_list_report_tags.

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

Reset the organization email branding settings back to defaults. Destructive operation. Requires confirm=True.

Restore a workbook to a previous version.

Revoke a member's OAuth refresh tokens (OIDC single sign-on and warehouse connections). Requires confirm=True. Sigma can no longer issue new access tokens for the member; the current session and already-issued access tokens last until their normal expiry.

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).

Save a workbook as a reusable template.

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

Export (send) a report once to one or more targets. body requires targets, config and attachments, and may set parameters and timeout, per Sigma's POST /v2/reports/{reportId}/send.

Export (send) a workbook once to one or more targets: email, Slack, Google Sheets/Drive, or a webhook. body follows Sigma's POST /v2/workbooks/{workbookId}/send: target (list of targets), configV2 (format and element or page to export), plus optional parameters, conditions, timeout and sendAsUser.

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"}]

Set a user attribute value for specific users. assignments: List of objects, each with 'userId' (str) and 'value' (str). Example: [{"userId": "abc123", "value": "US"}]

Share a workbook with other Sigma organizations. body requires orgSlugs (list of organization slugs) and may set shareDatasets, copyInputTableData, sendEmail and emailMessage.

Swap data sources for a data model.

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

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

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

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

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

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

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

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

Test connectivity for a connection.

Remove a document from a member's favorites. Requires confirm=True.

Update an API connector. body may set name, description, params, config and authId.

Update an API credential. body may set name, description, allowlist and credential.

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

Update a deployment policy. body may set name, nameInTenant, sourceSwapPolicies, copyInputTableData and useDependenciesWorkspace.

Update file properties (name, parentId for moving).

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

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.

Update a report from a code representation (JSON document specification). Mutating operation. Requires confirm=True and document_version integer to guard against concurrent overwrites.

Update a report's scheduled export. body may set target, schedule, configV2, description and suspensionAction. Retrieve schedule IDs with workbooks_list_report_schedules.

Update a source swap policy (Beta). body may set type, name, fromConnectionId and swaps.

Update a version tag. body may set name, description and color.

Update a team. body may set name, description and visibility.

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

Update a tenant organization. body may set tenantOrganizationName and tenantOrganizationSlug.

Replace the organization translation file for a language code. body requires translations.

Replace the organization translation file for a language code and variant. body requires translations.

Update a user attribute's definition. body may set userAttributeName, description and defaultValue.

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"]

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 admin_set_user_attribute_for_users instead.

Update a saved view (bookmark) in a workbook. body may set name, isShared, isDefault and exploreKey. Retrieve bookmark IDs with workbooks_list_workbook_bookmarks.

Update a workbook from a code representation (JSON document specification). Mutating operation. Requires confirm=True and document_version integer to guard against concurrent overwrites.

Update a workbook's scheduled export. body may set target, schedule (cronSpec, timezone), configV2, description and suspensionAction. Retrieve schedule IDs with workbooks_list_workbook_schedules.

Update (rename) a workspace. body requires name and may set noDuplicates.

Verify a report code representation specification without saving. Runs report creation as a dry run (``dryRun: true``). Returns ``{valid, errors, warnings}``. A success that does not echo ``dryRun: true`` fails the call (``dry_run_not_honored``) and names any ID that came back, since Sigma may then have created a real report.

Verify a workbook code representation specification without saving. Validates schema structure, syntax, and element layout through a dry run of workbook creation (``dryRun: true``). Returns ``{valid, errors, warnings}``. A success that does not echo ``dryRun: true`` fails the call (``dry_run_not_honored``) and names any ID that came back, since Sigma may then have created a real workbook.