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

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

List pages in a workbook.

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.

List data lineage for a workbook.

Get version history for a workbook.

Restore a workbook to a previous version.

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

List columns for a specific element in a workbook.

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.

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

Check status of a materialization job.

List materialization schedules for a workbook.

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.

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

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.

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.

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

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 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 source swap policies (rules for automatic source swapping on deployment).

Get a source swap policy.

Create a source swap policy for automated deployments.

List templates shared with your organization from other orgs.

Accept a pending template share from another organization.

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

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

Delete a tag. Requires confirm=True.

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

Get workspace details.

Create a new workspace.

Delete a workspace. Requires confirm=True.

List permission grants on a workspace.

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

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

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

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

Trigger materialization and poll until complete or timeout.

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

Add multiple members to a team in one call.

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.

tag_color: Color for newly created tags. One of: cyan, grass, violet, plum, amber, bronze. Ignored if the tag already exists. Defaults to 'cyan'.

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.

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.

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

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 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 workbooks in the organization, automatically following pagination.

List ALL members in the organization, automatically following pagination.

List ALL teams in the organization, automatically following pagination.

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

List ALL reports in the organization, automatically following pagination.

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

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

List recently recorded incoming Sigma webhook events.

read_only_hint: True