# Gigasheet

Gigasheet is a big data automation platform that offers a spreadsheet-like interface for analyzing and managing large datasets, enabling users to automate tasks, integrate with various data sources, and streamline data workflows.

- **Category:** spreadsheets
- **Auth:** API_KEY
- **Tools:** 155
- **Triggers:** 0
- **Slug:** `GIGASHEET`
- **Version:** 20260217_00

## Tools

### Append Rows to Dataset

**Slug:** `GIGASHEET_APPEND_DATASET`

Appends rows to an existing Gigasheet dataset using column letters as keys. Use when you need to add new data rows to a sheet by specifying values for each column position (A, B, C, etc.).

### Append Sheet from Another Sheet

**Slug:** `GIGASHEET_APPEND_DATASET_FROM_SHEET`

Tool to append data from a source sheet to a target sheet by matching column names. Use when you need to combine data from two existing sheets based on column name matching rather than column IDs. This action matches columns from the source sheet to the target sheet based on column names, with options for case-insensitive matching and trimming whitespace. Unmatched columns can optionally be added as new columns to the target sheet.

### Apply HTTP Enrichment

**Slug:** `GIGASHEET_APPLY_USER_DEFINED_HTTP_ENRICHMENT`

Tool to apply generic HTTP enrichment to a Gigasheet dataset. Use when you need to enrich dataset rows by calling external APIs and adding the response data as new columns. This action creates an enrichment job that calls a specified HTTP endpoint for each row (or batch of rows) in your dataset, extracts data from the API responses using JSON paths, and creates new columns with the enriched data. The operation is asynchronous and returns a job handle for monitoring progress. Common use cases: - Enrich customer records by calling a CRM API - Validate email addresses using a validation service - Lookup product details from an external catalog - Geocode addresses using a mapping API - Fetch social media profiles for contact enrichment

### Calculate Enrich Expected Credits

**Slug:** `GIGASHEET_CALCULATE_ENRICH_EXPECTED_CREDITS`

Calculate expected credits for a user-defined HTTP enrichment operation. Use this before initiating an enrichment to estimate costs based on the number of rows and columns that will be processed. This tool helps you: - Estimate credit costs before running an enrichment - Understand resource requirements for filtered enrichments - Plan budget for large-scale enrichment operations

### Cancel HTTP Enrichment Task

**Slug:** `GIGASHEET_CANCEL_ENRICH_USER_DEFINED_HTTP_TASK`

Tool to cancel a running enrichment task. Use when you need to stop an in-progress HTTP enrichment job that was previously initiated. This action attempts to cancel an enrichment task identified by its task handle. Cancellation is only possible for tasks that are still in progress (not yet completed or already failed). The task handle is returned when you start an enrichment job using the apply enrichment endpoint.

### Check Connector Source Availability

**Slug:** `GIGASHEET_CHECK_CONNECTORS_SOURCES_CONNECTORNAME`

Tool to check if a source of the given type is available. Use this to verify whether a specific connector integration (e.g., Snowflake, Salesforce) is configured and available for the authenticated user. This updates corresponding connection statuses.

### Combine Files

**Slug:** `GIGASHEET_COMBINE_FILES`

Tool to combine multiple files into a new file. Use when you need to merge several files where column names and types match. Optionally add source filename tracking or append rows to the first file in-place.

### Copy File

**Slug:** `GIGASHEET_COPY_FILE`

Tool to copy a file in Gigasheet. Use when you need to duplicate an existing file/sheet into your library with an optional new name and destination folder.

### Count Dataset Deduplication Results

**Slug:** `GIGASHEET_COUNT_DATASET_DEDUPLICATE_ROWS`

Tool to count how many duplicates will be removed and how many rows remain when deduplicating. Use when you need to preview the impact of a deduplication operation before executing it, or to understand the number of duplicate rows in a dataset based on specific column combinations.

### Count Dataset Groups

**Slug:** `GIGASHEET_COUNT_DATASET_GROUPS`

Tool to count the number of groups matching certain criteria in a Gigasheet dataset. Use when you need to determine how many distinct groups exist based on specified row grouping columns and optional filters. This action is useful for understanding data distribution and cardinality before performing more expensive operations like full group aggregations. It supports advanced features like pivot mode, filtering, and sorting configurations.

### Count Dataset Rows

**Slug:** `GIGASHEET_COUNT_DATASET_ROWS`

Counts rows in a Gigasheet dataset matching specified filter criteria. Returns the number of rows matching the provided filters, groupings, and other parameters. For basic row counting, only the handle and optionally filterModel need to be specified. Advanced features like pivot mode, grouping, and aggregations are available for complex counting scenarios. Common use cases: - Count all rows in a dataset - Count rows matching specific filter conditions - Count grouped rows in pivot tables - Validate filter results before exporting data For detailed information on constructing filter models, refer to the Gigasheet Filter Model Detail Guide at https://gigasheet.readme.io/reference/post_dataset-handle-count-rows

### Count Dataset Activities

**Slug:** `GIGASHEET_COUNT_DATASETS_ACTIVITY_COUNT`

Tool to get total activity count on a given Gigasheet dataset. Use when you need to determine how many activities (creates, updates, deletes) have been performed on a dataset. This action counts activities matching the specified criteria such as time range, users, action types, and categories. Non-blank criteria are AND-ed together, while multi-value fields (Actions, Categories, Users) are OR-ed. Returns the total count of matching activities.

### Create AI Chat Query

**Slug:** `GIGASHEET_CREATE_AI_CHAT`

AI analysis assistant for Gigasheet datasets. Use this to ask natural language questions about sheet data and get AI-powered insights. Only available for sheets where you have write permissions. Common use cases: - Get summaries of data patterns and trends - Ask questions about specific columns or values - Request analysis of data relationships - Extract key insights from large datasets Note: Requires write access to the target sheet.

### Create Dataset Column Comment

**Slug:** `GIGASHEET_CREATE_DATASET_COLUMN_COMMENT`

Tool to add a comment to a column in a Gigasheet dataset. Use this when you need to annotate or document a specific column with explanatory text. Optionally notify other users by tagging their email addresses.

### Add Comment to Cell

**Slug:** `GIGASHEET_CREATE_DATASET_COMMENT`

Tool to add a comment to a specific cell in a Gigasheet dataset. Use when you need to annotate or add notes to a particular cell location in the sheet.

### Create Conditional Label Column

**Slug:** `GIGASHEET_CREATE_DATASET_CONDITIONAL_LABEL_COLUMN`

Tool to add a label column to a Gigasheet dataset with values based on conditional filters. Use when you need to categorize or label rows based on column values. This action creates a new column where each row's label is determined by evaluating filter conditions. Cases are evaluated in order, and the first matching case determines the label. Rows not matching any case receive the defaultLabel (if specified). Before using this tool: 1. Obtain a valid dataset handle using actions like GIGASHEET_POST_UPLOAD_URL or GIGASHEET_GET_DATASET_HANDLE 2. Identify column IDs/names using GIGASHEET_GET_DATASET_HANDLE_COLUMNS 3. Construct appropriate filter models - note that filter values must be strings even for numeric comparisons Example use case: Create a "Priority" column that labels rows as "High" if Amount > 1000, "Medium" if Amount > 100, otherwise "Low".

### Create Formula Column

**Slug:** `GIGASHEET_CREATE_DATASET_FORMULA`

Tool to create a new column based on a formula input in a Gigasheet dataset. Use when you need to calculate values based on existing columns. This action creates a new column with values computed from a formula. You must reference columns by letter (e.g., 'A', 'B', 'C') using the 'formula' parameter. The 'literalFormula' parameter can be provided alongside 'formula' for documentation purposes to show the human-readable column names, but cannot be used alone. Formula syntax supports: - Column references: A, B, C (required, use column letters) - Arithmetic operations: +, -, *, / - Functions: UPPER(), LOWER(), CONCATENATE(), etc. - Example: "A * 2", "UPPER(B)", "CONCATENATE(B, C)" Before using this tool: 1. Obtain a valid dataset handle using GIGASHEET_POST_UPLOAD_URL or GIGASHEET_GET_DATASET_HANDLE 2. Use GIGASHEET_GET_DATASET_HANDLE_COLUMNS to identify column letters for formula construction 3. Construct the appropriate formula expression based on your calculation needs

### Edit Formula Column

**Slug:** `GIGASHEET_CREATE_DATASET_FORMULA_EDIT`

Tool to edit a formula column in a Gigasheet dataset. Use when you need to update an existing formula column with a new formula, rename it, or reposition it. The column must already exist and be a formula column created previously.

### Create Formula Preview

**Slug:** `GIGASHEET_CREATE_DATASET_FORMULA_PREVIEW`

Tool to calculate a formula preview on a Gigasheet dataset and return sample results with involved column values. Use this action when you need to: - Test a formula expression before applying it to an entire column - Preview formula calculations on sample data - Validate formula syntax and see example outputs - View which columns are involved in the formula computation The action returns sample rows showing the formula result along with the values from columns referenced in the formula. This is useful for validating formulas before creating computed columns or performing bulk calculations.

### Create Iterator Column

**Slug:** `GIGASHEET_CREATE_DATASET_ITERATOR_COLUMN`

Tool to add an iterator column to a Gigasheet dataset based on current filters and order. Use when you need sequential row numbers in your data. This action creates a new column with sequential numbers (1, 2, 3, ...) for each row. The numbering respects any applied filters and sort order, making it useful for ranking, indexing, or tracking row positions after data transformations. Before using this tool: 1. Obtain a valid dataset handle using GIGASHEET_POST_UPLOAD_URL or GIGASHEET_GET_DATASET_HANDLE 2. Optionally define filters using filterModel to number only specific rows 3. Optionally specify sort order using sortModel to control the numbering sequence

### Create Dataset Liveshare

**Slug:** `GIGASHEET_CREATE_DATASET_LIVESHARE`

Tool to create a new liveshare for a Gigasheet dataset. Returns a share ID and URL for accessing the current CSV data in the sheet. Use when you need to generate a shareable link that provides live access to dataset content.

### Create Dataset View

**Slug:** `GIGASHEET_CREATE_DATASET_VIEW`

Tool to create a new view for a Gigasheet dataset with a specified name and client state version. Use when you need to save a specific dataset state as a named view for later reference.

### Explode JSON Column

**Slug:** `GIGASHEET_CREATE_EXPLODE_JSON`

Tool to explode JSON data in a column into separate columns. Extracts all keys from JSON objects and creates a new column for each key. Use when you need to flatten nested JSON data in a Gigasheet dataset.

### Create File Aggregation

**Slug:** `GIGASHEET_CREATE_FILE_AGGREGATION`

Tool to retrieve ungrouped aggregated values for a Gigasheet file. Returns aggregated data as specified in the request payload, including support for pivot mode, filtering, sorting, and various aggregation functions. Use when you need to compute summary statistics across columns without grouping by specific keys.

### Create Blank File

**Slug:** `GIGASHEET_CREATE_FILES_BLANK`

Tool to create an empty file in your Gigasheet Library. Use when you need a blank spreadsheet with a specified number of rows and columns.

### Create Files Directory

**Slug:** `GIGASHEET_CREATE_FILES_DIRECTORY`

Tool to create a new folder in your Gigasheet Library. Use when you need to organize datasets by creating a new directory for file storage.

### Create Cross-File Lookup

**Slug:** `GIGASHEET_CREATE_LOOKUP`

Creates a cross-file lookup to enrich data by matching values between two sheets. Use when you need to pull related data from a reference sheet into your source sheet based on matching column values. This is similar to VLOOKUP in Excel. Before using this tool: 1. Obtain valid handles for both the source and reference datasets 2. Identify the column IDs (A, B, C, etc.) in both sheets using GIGASHEET_GET_DATASET_HANDLE_COLUMNS 3. Ensure the columns you're matching have compatible data types The lookup will create a new column in the source sheet with values from the reference sheet where matches are found.

### Send MCP Request to Sheet Assistant

**Slug:** `GIGASHEET_CREATE_MCP`

Tool to interact with Gigasheet Sheet Assistant via the Model Context Protocol (MCP) over HTTP. Use when you need to query or manipulate sheet data through MCP-compatible LLM tools. This endpoint implements JSON-RPC 2.0 protocol and supports MCP methods like 'tools/list' (to discover available tools) and 'tools/call' (to execute specific tools). The Sheet Assistant can perform operations like querying data, analyzing sheets, and other data manipulation tasks.

### Split Column

**Slug:** `GIGASHEET_CREATE_SPLIT_COLUMN`

Tool to split a column into multiple columns based on a separator. Use when you need to divide column values into separate columns in a Gigasheet dataset.

### Delete Sheet Assistant Logs

**Slug:** `GIGASHEET_DELETE_AI_HANDLE_LOGS`

Tool to delete Sheet Assistant chat history for a specific sheet. Use when you need to clear all AI assistant conversation logs associated with a sheet handle.

### Delete columns by name

**Slug:** `GIGASHEET_DELETE_COLUMNS_BY_NAME`

Tool to delete multiple columns from a Gigasheet dataset by their column names. Use when you need to remove specific columns from a sheet.

### Delete Connector Source

**Slug:** `GIGASHEET_DELETE_CONNECTORS_SOURCES_CONNECTORNAME`

Tool to delete a connector source for the authenticated user. Use when you need to remove an integration connection such as Salesforce, S3, or Google Sheets from Gigasheet.

### Delete Dataset Comment

**Slug:** `GIGASHEET_DELETE_DATASET_COMMENT`

Tool to delete a comment from a cell in a Gigasheet dataset. Use this when you need to remove a specific comment that was previously added to a cell. The comment ID can be obtained using the list comments action.

### Delete Duplicated Rows from Dataset

**Slug:** `GIGASHEET_DELETE_DATASET_HANDLE_DEDUPLICATE_ROWS`

Tool to delete duplicated rows from a Gigasheet dataset based on specified columns and sort model. Use when you need to remove duplicate entries identified by matching values in one or more columns. When multiple rows have identical values in the specified columns, the sort model determines which row to keep (if not specified, default sheet row order is used). Optionally apply a filter to deduplicate only a subset of rows.

### Delete Rows from Dataset

**Slug:** `GIGASHEET_DELETE_DATASET_HANDLE_DELETE_ROWS`

Tool to delete selected rows from a Gigasheet dataset. Use when you need to remove specific rows identified by their row IDs (iterator numbers). Row IDs are subject to change, so it's best practice to obtain them immediately before deletion using a query or list action.

### Delete Rows Matching Filter

**Slug:** `GIGASHEET_DELETE_DATASET_HANDLE_DELETE_ROWS_MATCHING_FILTER`

Tool to delete rows in a Gigasheet dataset that match a specified filter. Use when you need to remove specific rows based on filter criteria. The filterModel uses Conjunctive Normal Form (CNF) structure with column identifiers, filter values, and match conditions.

### Delete Rows Not Matching Filter

**Slug:** `GIGASHEET_DELETE_DATASET_HANDLE_DELETE_ROWS_NOT_MATCHING_FILTER`

Deletes rows in a Gigasheet dataset that do NOT match the specified filter criteria. Use this when you want to keep only the rows that match a filter and remove everything else. The filter uses Conjunctive Normal Form (CNF) where conditions can be combined with AND/OR logic.

### Delete dataset view

**Slug:** `GIGASHEET_DELETE_DATASET_HANDLE_VIEWS_VIEW`

Tool to delete a specific view from a Gigasheet dataset. Use when you need to remove a saved view from a dataset. Requires both the dataset handle and the view handle to identify the view to delete.

### Delete dataset live share

**Slug:** `GIGASHEET_DELETE_DATASET_LIVESHARE_SHAREID`

Tool to delete a live share of a Gigasheet dataset. Use when you need to revoke or remove an existing live share link. The shareid is the unique identifier of the live share to be deleted.

### Delete sheet or folder by handle

**Slug:** `GIGASHEET_DELETE_DELETE_HANDLE`

Deletes a Gigasheet sheet or folder by its unique handle identifier. For sheets, this permanently removes the dataset. For folders, use recursive=True to delete the folder along with all its contents (sheets and subfolders), or omit/set to false to delete only empty folders. The handle can be obtained from sheet URLs or from create/upload operations.

### Delete column from sheet

**Slug:** `GIGASHEET_DELETE_FILES_COLUMNS_COLUMN`

Tool to delete a single column from a Gigasheet sheet by its column identifier. Use when you need to permanently remove a specific column from a sheet.

### Delete Filter Template

**Slug:** `GIGASHEET_DELETE_FILTER_TEMPLATES_FILTER_HANDLE`

Tool to delete a saved filter template by its unique handle. Use when you need to remove a persisted filter configuration that is no longer needed.

### Delete multiple columns from file

**Slug:** `GIGASHEET_DELETE_MULTIPLE_COLUMNS`

Tool to delete multiple columns from a Gigasheet file. Use when you need to remove specific columns from a sheet by their identifiers.

### Filter File Rows

**Slug:** `GIGASHEET_FILTER_FILE_ROWS`

Tool to retrieve rows from a Gigasheet file matching specified filter criteria. Use when you need to query or extract data from a sheet with optional filtering, sorting, and pagination. For basic filtering, only the filterModel field needs to be specified.

### Generate Dataset Description

**Slug:** `GIGASHEET_GENERATE_DATASET_DESCRIPTION`

Generates an AI-powered description for a Gigasheet dataset. Use this when you need to automatically create a summary or description of a dataset's content and structure based on its data.

### Get Sheet AI Chat History

**Slug:** `GIGASHEET_GET_AI_HANDLE_LOGS`

Tool to retrieve AI chat history for a sheet. Returns up to 20 most recent messages exchanged with the sheet assistant. Use when you need to review previous AI interactions or understand the conversation context for a specific sheet.

### Get Cell Comments

**Slug:** `GIGASHEET_GET_CELL_COMMENTS`

Tool to get comments for a specific cell in a Gigasheet dataset. Use when you need to retrieve comments that have been added to a particular cell at the intersection of a column and row.

### Get Client State Current Version

**Slug:** `GIGASHEET_GET_CLIENT_STATE_CURRENT_VERSION`

Retrieves the current client-state version and timestamp for a specified sheet. The version identifier is used when creating or updating views and saved states. Call this action after obtaining a sheet handle to get the latest version before performing state-related operations.

### Get Connector Connection Parameters

**Slug:** `GIGASHEET_GET_CONNECTOR_CONNECTION_PARAMS`

Tool to get connection parameters for a specific connector. Use when you need to discover what parameters are required to set up a connector integration.

### Get Connector Connection Parameters

**Slug:** `GIGASHEET_GET_CONNECTORS_CONNECTION_PARAMS_CONNECTORNAME`

Tool to retrieve connection parameters for a specific connector type. Use when you need to discover what parameters are required to configure a data source connection.

### Get Connector Connections

**Slug:** `GIGASHEET_GET_CONNECTORS_CONNECTIONS`

Tool to list connector connections. Use after setting a valid Gigasheet API token.

### Get Connector Sources

**Slug:** `GIGASHEET_GET_CONNECTORS_SOURCES`

Tool to retrieve information about connected data sources for the user. Returns a list of data sources with their type, status, and folder location. Use after setting a valid Gigasheet API token.

### Get Connector Source Parameters

**Slug:** `GIGASHEET_GET_CONNECTORS_SOURCES_PARAMS_CONNECTORNAME`

Tool to get parameters required for a specific connector source type. Use when configuring a data source connection to understand what information needs to be collected from the user.

### Get Dataset Column Comments

**Slug:** `GIGASHEET_GET_DATASET_COLUMN_COMMENTS`

Tool to get comments for a specific column in a dataset sheet. Use when you need to retrieve comments that have been added to a particular column.

### Get Dataset by Handle

**Slug:** `GIGASHEET_GET_DATASET_HANDLE`

Retrieves comprehensive metadata for a specific dataset in Gigasheet. This tool fetches detailed information about a dataset including its processing status, file properties, column structure, owner information, and more. Use this after uploading a file or when you have a valid dataset handle to get its current state and schema. Common use cases: - Check if a dataset has finished processing (Status field) - Get column names and data types for the dataset - Retrieve file size, row count, and creation timestamps - Verify dataset ownership and access

### Get Dataset Columns

**Slug:** `GIGASHEET_GET_DATASET_HANDLE_COLUMNS`

Tool to list all column metadata (IDs, names, types) for a dataset. Use after obtaining a dataset handle.

### Get Dataset Export Download URL

**Slug:** `GIGASHEET_GET_DATASET_HANDLE_DOWNLOAD_EXPORT`

Tool to retrieve the download URL for an exported dataset. Use after initiating an export and obtaining its handle.

### Get Dataset Liveshare CSV

**Slug:** `GIGASHEET_GET_DATASET_HANDLE_LIVESHARE_SHAREID`

Tool to retrieve CSV data from a Gigasheet liveshare. Returns the current data in text CSV format. Use when you need to export or access shared dataset data via a liveshare link.

### Get Dataset Note

**Slug:** `GIGASHEET_GET_DATASET_HANDLE_NOTE`

Tool to retrieve a dataset's note by handle. Use this to get AI-generated or user-provided descriptions of a dataset.

### Get Dataset Organization Permissions

**Slug:** `GIGASHEET_GET_DATASET_HANDLE_ORGANIZATION_PERMISSIONS`

Tool to retrieve organization file permissions for a dataset. Use when you need to check what permissions the requester's organization has on a specific file. This action returns permissions only for the same organization that the requester is a member of. The permissions are returned as a list of integers representing different permission levels.

### Get Dataset Version Metadata

**Slug:** `GIGASHEET_GET_DATASET_HANDLE_VERSION`

Retrieves metadata about a dataset at a specific version. Returns information including file name, column names and types, row count, modification timestamp, and processing status. Use this when you need to access historical versions of a dataset or verify dataset state at a particular point in time.

### Get Dataset Views

**Slug:** `GIGASHEET_GET_DATASET_HANDLE_VIEWS`

Tool to list all views associated with a specific dataset. Use after confirming the dataset handle and its status.

### Get Dataset Operation Status

**Slug:** `GIGASHEET_GET_DATASET_OPERATION_STATUS`

Tool to get information about the last operation on a dataset. Use when you need to check if a long-running operation (like import, export, or data transformation) has completed.

### Get Dataset Activity

**Slug:** `GIGASHEET_GET_DATASETS_HANDLE_ACTIVITY`

Tool to get the list of write actions on a given dataset sheet. Use this to retrieve the activity history and audit trail of modifications made to a dataset.

### Get Dataset View Metadata

**Slug:** `GIGASHEET_GET_DATASET_VIEWS`

Tool to retrieve view metadata for a specific view within a dataset. Use when you have both a dataset handle and a view handle to get detailed view information.

### Get Docs Formulas Functions

**Slug:** `GIGASHEET_GET_DOCS_FORMULAS_FUNCTIONS`

Tool to retrieve all supported formula functions. Use after authenticating with a valid API token.

### Get Enrich Task Status

**Slug:** `GIGASHEET_GET_ENRICH_USER_DEFINED_HTTP_TASK_HANDLE`

Tool to get status for a user-defined HTTP enrichment task. Use when you need to check if an enrichment operation has completed or to monitor its progress.

### Apply Filter Template On Sheet

**Slug:** `GIGASHEET_GET_FILTER_TEMPLATE_ON_SHEET`

Tool to fetch a saved filter template's model for a given sheet. Use when you need the exact filter structure for a specific sheet and template.

### Get Filter Templates

**Slug:** `GIGASHEET_GET_FILTER_TEMPLATES`

Retrieves all saved filter templates from GigaSheet. Filter templates store reusable filter configurations that can be applied to datasets. Returns a list of templates with their IDs, names, owners, filter criteria, and timestamps. Supports optional pagination via the page parameter.

### Get Filter Template by Handle

**Slug:** `GIGASHEET_GET_FILTER_TEMPLATES_FILTER_HANDLE`

Retrieves details of a specific saved filter template by its unique handle. Use when you need to inspect a particular filter template's configuration, metadata, or filter criteria.

### Generate New Handle

**Slug:** `GIGASHEET_GET_GENERATE_HANDLE`

Tool to generate a new unique dataset handle. Use when you need a fresh FileUuid before creating or referencing datasets.

### Get Library Files

**Slug:** `GIGASHEET_GET_LIBRARY`

Tool to retrieve all datasets and files in the user's Gigasheet library. Returns all datasets owned by the user at any folder depth, files directly shared with the user, and IDs of files the user has shared. Use this to get a complete overview of all accessible files and their metadata including status, sharing permissions, and file properties.

### Get Library Files in Directory

**Slug:** `GIGASHEET_GET_LIBRARY_HANDLE`

Retrieves all library files with file permissions in a given directory. Returns library files owned by the user making the request, limited to the requested directory level only (does not include nested files from deeper subdirectories).

### Get Library Home Page Files

**Slug:** `GIGASHEET_GET_LIBRARY_HOME`

Tool to retrieve suggested recent files for the home page. Returns a list of recently accessed datasets with metadata, permissions, and sharing information. Use when you need to display or work with the user's recent files.

### Get Library Path

**Slug:** `GIGASHEET_GET_LIBRARY_PATH`

Tool to retrieve the chain of parent directories for a file or folder in Gigasheet. Returns the complete path hierarchy from root to the specified item, sorted by folder level. Use when you need to understand the location of a file or folder within the library structure.

### Get Source Connector Parameters

**Slug:** `GIGASHEET_GET_SOURCES_PARAMS2`

Tool to get parameters required for a specific data source connector. Use when you need to discover what configuration fields are needed to set up a connection to a data source like MySQL, Postgres, Snowflake, etc.

### Get TICIntel NPI Public Profile

**Slug:** `GIGASHEET_GET_TICINTEL_NPI_NPI_PUBLIC`

Tool to retrieve public NPI (National Provider Identifier) profile from TICIntel database. Use when you need comprehensive information about a healthcare provider including their specialty, location, procedures, payment rates, and TICIntel scoring data. The NPI must be a valid 10-digit number registered in the TICIntel database.

### Get Public NPI Profile

**Slug:** `GIGASHEET_GET_TICINTEL_NPI_PUBLIC`

Tool to retrieve public NPI (National Provider Identifier) profile information for healthcare providers. Use this when you need to look up provider details, specialties, locations, or TIC scores by NPI number. Returns comprehensive provider data including taxonomy, procedures, and location information.

### Get TIC Intel States

**Slug:** `GIGASHEET_GET_TICINTEL_STATES`

Tool to list available TIC Intel states from Gigasheet. Returns a list of state names or codes that can be used for TIC Intel data queries. Use when you need to know which states are available for TIC Intel analysis.

### List Cities by State

**Slug:** `GIGASHEET_GET_TICINTEL_STATES_STATE_CITIES`

Tool to retrieve a list of cities for a given US state code from the TICIntel dataset. Use when you need to get all available cities within a specific state.

### List Providers by City

**Slug:** `GIGASHEET_GET_TICINTEL_STATES_STATE_CITIES_CITY_PROVIDERS`

Tool to retrieve a list of healthcare providers in a specific city and state from the TicIntel dataset. Use when you need to find providers by geographic location.

### Get User Details

**Slug:** `GIGASHEET_GET_USER_DETAILS`

Retrieves detailed information about the authenticated user in Gigasheet. Use when you need to check user account details, storage quota usage, or verify assigned roles and permissions.

### Get User Enrichment Credits

**Slug:** `GIGASHEET_GET_USER_ENRICHMENT_CREDITS`

Tool to get the current user's enrichment credit information. Use when you need to check available enrichment credits or usage.

### Get User Metadata

**Slug:** `GIGASHEET_GET_USER_METADATA`

Tool to retrieve metadata for the authenticated user. Returns user metadata including billing info, feature flags, and onboarding status. Use when you need to fetch user configuration or settings.

### Get User Autofill Suggestions

**Slug:** `GIGASHEET_GET_USERS_AUTOFILL`

Retrieves autofill suggestions for the authenticated user, including team members and previously used share recipients. Useful for autocomplete functionality when sharing files or collaborating with team members.

### Get User Space Used

**Slug:** `GIGASHEET_GET_USER_SPACE_USED`

Tool to get the amount of space used by the current user in bytes. Use when you need to check storage usage.

### Get Authenticated User Info

**Slug:** `GIGASHEET_GET_USER_WHOAMI`

Tool to fetch the authenticated user's details. Use after setting a valid Gigasheet API token.

### List Billing Plans

**Slug:** `GIGASHEET_LIST_BILLING_PLANS`

Tool to list available Gigasheet billing plans. Returns all billing plans with their item details and pricing information. Use when you need to view subscription options.

### List Dataset Comments

**Slug:** `GIGASHEET_LIST_DATASET_COMMENTS`

Tool to get all comments in a dataset sheet. Use this when you need to retrieve comments that have been added to cells in the dataset.

### List Dataset Liveshares

**Slug:** `GIGASHEET_LIST_DATASET_LIVESHARES`

Tool to list all liveshares for a specific Gigasheet dataset. Use when you need to view existing shared links for a dataset.

### List All Datasets

**Slug:** `GIGASHEET_LIST_DATASETS`

Tool to retrieve all datasets owned by the user at any folder depth. Returns a list of datasets with their metadata. The API may trim certain fields to keep response size manageable. Use the 'types' parameter to filter by dataset type (sheet or export).

### List Datasets by Handle

**Slug:** `GIGASHEET_LIST_DATASETS_BY_HANDLE`

Tool to list files and datasets in a given Gigasheet location. Use when you need to browse the contents of a parent dataset or folder, optionally filtering by type (sheet or export). Supports pagination for large result sets. Returns metadata about each file including handle, name, size, status, and timestamps.

### List Library Exports

**Slug:** `GIGASHEET_LIST_LIBRARY_EXPORTS`

Tool to list exports owned by the current user, regardless of location. Use when you need to retrieve all exports associated with the authenticated user's account.

### List Shared Files by Handle

**Slug:** `GIGASHEET_LIST_SHARED_FILES_BY_HANDLE`

Tool to retrieve all files with permissions shared with the user in a specific directory location. Use when you need to see what files have been shared with you in a particular folder. Returns files limited to the requested directory level and will not return nested files at any deeper directory level.

### Move file or folder to directory

**Slug:** `GIGASHEET_MOVE_FILE_DIRECTORY`

Tool to move a file or folder into a folder or to the root of your Library. Use when organizing your Gigasheet workspace. The destination folder must already exist, and creating directory loops is forbidden.

### Update User Metadata

**Slug:** `GIGASHEET_PATCH_USER_METADATA`

Tool to update user metadata in Gigasheet. Use this to modify user-level settings such as billing integration (Chargebee ID), feature flags (pre-analysis), and onboarding state. At least one field must be provided to perform the update.

### Generate AI Formula

**Slug:** `GIGASHEET_POST_AI_HANDLE_FORMULATE`

Tool to generate Excel-style formulas using AI based on natural language queries. Use when you need to create formulas for data transformation, calculation, or extraction on a Gigasheet dataset. This action is available for sheets where you have read permissions. Provide a natural language description of the operation you want to perform, and the AI will generate the appropriate formula syntax that can be applied to your sheet data.

### Cast Column Data Type

**Slug:** `GIGASHEET_POST_CAST_COLUMN_HANDLE_COLUMN`

Tool to change a column's data type in a Gigasheet dataset. Use when you need to convert column data from one type to another (e.g., string to number, text to IP address). The operation is asynchronous and returns a success acknowledgment.

### Change Column Case

**Slug:** `GIGASHEET_POST_CHANGE_CASE_HANDLE_COL`

Tool to change the case of a column to Uppercase, Lowercase, Capitalized, or Proper. Use when you need to standardize text formatting in a column for consistency or data processing requirements.

### Clean Company Name

**Slug:** `GIGASHEET_POST_CLEAN_COMPANY_NAME_HANDLE_COL`

Tool to clean company names by stripping common business suffixes (Inc., LLC, Corp., etc.). Use when standardizing company names to avoid duplicates. Currently works only on English-alphabet versions of names.

### Combine Columns

**Slug:** `GIGASHEET_POST_COMBINE_COLUMNS_HANDLE`

Tool to combine multiple columns into a single new column with a separator. Use when you need to merge column values from a Gigasheet dataset.

### Get Connector Source Parameters

**Slug:** `GIGASHEET_POST_CONNECTORS_SOURCES_PARAMS_CONNECTORNAME`

Tool to get required parameters for a specific connector source type. Use when you need to know what configuration fields are required for a given data source integration.

### Append Rows to Sheet by Name

**Slug:** `GIGASHEET_POST_DATASET_HANDLE_APPEND_BY_NAME`

Appends one or more rows to a Gigasheet dataset using column names as keys. This tool adds new rows to an existing dataset by matching the keys in each record to the column names in the sheet. Column names must match exactly (case-sensitive). You can provide partial records (only some columns), and missing columns will be left empty. Before using this tool: 1. Obtain a valid dataset handle (e.g., using GIGASHEET_POST_UPLOAD_URL or GIGASHEET_GET_DATASET_HANDLE) 2. Retrieve column names using GIGASHEET_GET_DATASET_HANDLE_COLUMNS to ensure you use correct names The API will return an error if the handle is invalid or column names don't match.

### Generate Dataset Assistant Tips

**Slug:** `GIGASHEET_POST_DATASET_HANDLE_ASSISTANT_TIPS`

Tool to generate AI-powered tips for analyzing a dataset. Use when you need suggestions for data analysis or exploration. This action generates intelligent recommendations based on the dataset structure and content to help users discover insights and perform meaningful analyses.

### Initiate Dataset Export

**Slug:** `GIGASHEET_POST_DATASET_HANDLE_EXPORT`

Initiates an asynchronous export job for a Gigasheet dataset. Returns an export job handle that can be used with the download export endpoint to retrieve the exported file once processing completes. Use this action when you need to: - Export a complete dataset to CSV format - Export a filtered subset of data by applying column filters - Create downloadable data snapshots for sharing or backup The export process is asynchronous - this action queues the job and returns immediately with a handle. Use the GET /dataset/{handle}/download-export endpoint to poll the export status and download the file when ready. Example usage: 1. Export entire dataset: {"handle": "9f60b220_8716_49eb_ad53_a206f8aaa0bf"} 2. Export with filter: {"handle": "9f60b220_8716_49eb_ad53_a206f8aaa0bf", "gridState": {"filterModel": {"Year": {"type": "equals", "filter": "2023"}}}}

### Find and Replace in Dataset

**Slug:** `GIGASHEET_POST_DATASET_HANDLE_FIND_AND_REPLACE`

Tool to find and replace values in specified columns of a Gigasheet dataset. Use when you need to update or clean data by replacing specific values across one or more columns. This action creates a new column with the replaced values (keeping the original column name) and renames the original column to 'Original Values - [column name]' for reference.

### Insert Blank Row in Dataset

**Slug:** `GIGASHEET_POST_DATASET_HANDLE_INSERT_BLANK_ROW`

Tool to insert a blank row with null values into a dataset. Use after determining the insertion index.

### Rename Columns to Unique

**Slug:** `GIGASHEET_POST_DATASET_HANDLE_RENAME_COLUMNS_TO_UNIQUE`

Tool to rename all columns in a dataset to unique names. Use when duplicate column names could cause conflicts in downstream processing.

### Save Current View

**Slug:** `GIGASHEET_POST_DATASET_HANDLE_SAVE_CURRENT_VIEW`

Saves the current view state of a Gigasheet dataset and returns a view handle. This operation captures the current layout, filters, sorts, column visibility, and other view settings of the dataset at the time of the call. The returned view handle can be used to reference this saved view state later. Use this after applying filters, sorts, or other transformations that you want to preserve.

### Select columns by name

**Slug:** `GIGASHEET_POST_DATASET_HANDLE_SELECT_COLUMNS_BY_NAME`

Tool to select specific columns from a Gigasheet dataset by name, keeping only those columns in the specified order. Use when you need to reduce a dataset to only certain columns or reorder columns. All columns not specified will be deleted, but the row number column is always retained automatically.

### Extract Domain from URL Column

**Slug:** `GIGASHEET_POST_EXTRACT_DOMAIN_HANDLE_COL`

Tool to extract domain from a URL column in a Gigasheet dataset. Use when you need to parse URLs and extract just the domain portion (e.g., extracting 'example.com' from 'https://www.example.com/path').

### Filter File Rows by Column Name

**Slug:** `GIGASHEET_POST_FILE_HANDLE_FILTER_BY_NAME`

Filter rows in a Gigasheet file by column names and return matching results. This endpoint uses column names directly (not column IDs) and supports text, number, and date filters. Use this when you need to query data with specific filter conditions and know the exact column names.

### Get Filtered Row Index

**Slug:** `GIGASHEET_POST_FILE_HANDLE_FILTER_SHEET_ROW_NR`

Maps an unfiltered row number to its position in the filtered result set. Returns the 1-based index of where a specific row appears after filters are applied, or 0 if the row is filtered out. Useful for locating specific rows when filters are active on a sheet.

### Filter File with Stream Progress

**Slug:** `GIGASHEET_POST_FILE_HANDLE_FILTER_STREAM_PROGRESS`

Filter data from a Gigasheet file with real-time streaming progress updates. Returns filtered rows along with processing statistics (bytes and rows processed). Use when you need to apply filters to a dataset and retrieve the filtered results with pagination support.

### Save Exported File

**Slug:** `GIGASHEET_POST_FILE_HANDLE_SAVE_EXPORTED`

Saves a file state with applied filters and grouping to create an exported version. Returns a JSON response acknowledging if the save request was successful. Use this action when you need to persist filtered or grouped views of a dataset as a separate exported file. The operation is asynchronous and returns an export handle to track the job status.

### Combine Files by Name

**Slug:** `GIGASHEET_POST_FILES_COMBINE_BY_NAME`

Tool to combine multiple files by a shared column name. Use when you need to merge several Gigasheet files based on a common header.

### Export Gigasheet to S3

**Slug:** `GIGASHEET_POST_MAVEN_EXPORT`

Tool to export Gigasheet data to AWS S3. Use after generating an export handle and ensuring the S3 bucket has correct permissions.

### Import from S3

**Slug:** `GIGASHEET_POST_MAVEN_IMPORT`

Tool to import data from AWS S3 into your Gigasheet Library. Use when you need to pull objects or prefixes from an S3 bucket into Gigasheet.

### Request Access to File

**Slug:** `GIGASHEET_POST_REQUEST_ACCESS_HANDLE`

Tool to request access to a Gigasheet file. Use when you need permission to view or edit a file owned by another user.

### Request API Access

**Slug:** `GIGASHEET_POST_REQUEST_API_ACCESS`

Request API access by sending a notification to Gigasheet support team. This tool sends a notification email to Gigasheet support requesting API key access for the authenticated user. The Gigasheet team will review the request and provide an API key separately. This does NOT immediately return an API key. Use this when you need to initiate the process of obtaining API access credentials.

### Trim Column Whitespace

**Slug:** `GIGASHEET_POST_TRIM_WHITESPACE_HANDLE_COL`

Tool to trim leading and trailing whitespace from all values in a column. Use when you need to clean up text data and remove extra spaces for consistency and data quality.

### Unroll Delimited Column

**Slug:** `GIGASHEET_POST_UNROLL_DELIMITED_COLUMN_HANDLE_COLUMN`

Tool to explode a column containing delimited data into multiple rows. Use after confirming dataset handle and target column.

### Upload Raw Data Direct

**Slug:** `GIGASHEET_POST_UPLOAD_DIRECT`

Tool to upload raw data directly to Gigasheet using byte array contents. Use when you have file data as bytes and want to create a new sheet or append to an existing one.

### Upload from URL

**Slug:** `GIGASHEET_POST_UPLOAD_URL`

Tool to upload data to Gigasheet from a specified URL. Use when you have a public or pre-signed link and want to ingest it directly.

### Preview HTTP Enrichment

**Slug:** `GIGASHEET_PREVIEW_ENRICH_USER_DEFINED_HTTP`

Tool to preview a generic HTTP enrichment on a Gigasheet dataset before executing it on all rows. This action tests the HTTP enrichment configuration by executing a small sample of requests and returning both successful results and any failures. Use this to validate your enrichment configuration (URL template, headers, output mappings) before running it on the entire dataset. The preview shows: - Sample successful API responses with extracted values - Sample failed requests with error details - Execution time for performance estimation - Response type validation This is essential for debugging enrichment configurations and avoiding costly mistakes on large datasets.

### Set Dataset Client State Version

**Slug:** `GIGASHEET_PUT_DATASET_HANDLE_CLIENTSTATE_VERSION`

Applies or restores a specific client state version to a dataset. Client state includes view settings like filters, sorts, visible columns, and aggregations. Use this to restore a previously saved state or apply a specific version after making changes to the dataset.

### Update cell by column name and row

**Slug:** `GIGASHEET_PUT_DATASET_HANDLE_COL_ROW_BY_NAME`

Tool to update a cell in a dataset by specifying column name and row number. Use after dataset is loaded and column name uniqueness is ensured.

### Share file

**Slug:** `GIGASHEET_PUT_FILE_HANDLE_SHARE_FILE`

Tool to share a Gigasheet file with specified recipients. Use after creating or updating a sheet to grant email-based access.

### Opt out of shared file

**Slug:** `GIGASHEET_PUT_FILE_HANDLE_SHARE_OPT_OUT`

Tool to remove your access from a file that has been shared with you. Use when you want to opt out of a shared file.

### Create/Update Filter Template

**Slug:** `GIGASHEET_PUT_FILTER_TEMPLATES_FILTER_HANDLE`

Tool to create or update a saved filter template. Use when you need to persist or modify filter criteria by providing a filter handle and the filter model.

### Rename Columns by Name

**Slug:** `GIGASHEET_RENAME_COLUMNS_BY_NAME`

Tool to rename columns in a Gigasheet dataset using their current names. Use when you need to update column names to more descriptive or standardized values.

### Rename File

**Slug:** `GIGASHEET_RENAME_FILE`

Tool to rename a file in Gigasheet. Use when you need to change the display name of a sheet.

### Reset Client State to Default

**Slug:** `GIGASHEET_RESET_CLIENT_STATE`

Resets the client state of a sheet to the default state. This clears all view customizations including filters, sorts, visible columns, and aggregations, returning the sheet to its original default view. Use this when you need to remove all applied customizations and restore the initial state.

### Reset User Password

**Slug:** `GIGASHEET_RESET_USER_PASSWORD`

Tool to trigger password reset for the authenticated user. Use when a user needs to reset their password and has a valid API token.

### Run Formula Edit Column

**Slug:** `GIGASHEET_RUN_FORMULA_EDIT_COLUMN`

Tool to edit an existing formula column in a Gigasheet dataset. Use when you need to update the formula expression for an existing formula column.

### Search Dataset Activity

**Slug:** `GIGASHEET_SEARCH_DATASETS_ACTIVITY`

Tool to search the history of write actions performed on a Gigasheet dataset. Use when you need to audit changes, track user activity, or review the modification history of a dataset. Returns a paginated list of activity entries including user information, timestamps, and action details. Supports filtering by action type, category, user, time range, and freeform search queries. All filter criteria are AND-ed together, while multiple values within a filter field are OR-ed.

### Search Library

**Slug:** `GIGASHEET_SEARCH_LIBRARY`

Tool to search through the Gigasheet file library by file metadata. Use when you need to find files by owner name, file name, column headers, or notes. By default searches across owner, file_name, headers, and note fields. You can optionally specify which metadata fields to search through. This does not search within file contents - only metadata.

### Send Invite Emails

**Slug:** `GIGASHEET_SEND_INVITE`

Tool to send email invitations to join Gigasheet. Use when you need to invite users to collaborate on the platform.

### Set Aggregate Filter Model

**Slug:** `GIGASHEET_SET_CLIENT_STATE_AGGREGATE_FILTER_MODEL`

Tool to set the aggregate filter model in the client state of a sheet. Use this to apply aggregate filtering to your data view by providing the sheet handle and the filter model object.

### Set Client State Aggregations

**Slug:** `GIGASHEET_SET_CLIENT_STATE_AGGREGATIONS`

Sets aggregations in the client state of a sheet. Aggregations allow you to compute summary statistics (sum, count, average, min, max, etc.) across columns in your dataset. Use this action to define which columns should display aggregated values and what type of calculation to apply. The aggregations are stored in the sheet's client state and will be visible when viewing the sheet.

### Set Client State Column State

**Slug:** `GIGASHEET_SET_CLIENT_STATE_COLUMN_STATE`

Tool to set column state in the client state of a sheet. Use to configure column widths, sort order, visibility, pinning, and aggregations. This updates the visual layout and behavior of columns in the grid view.

### Set Client State Filter Model

**Slug:** `GIGASHEET_SET_CLIENT_STATE_FILTER_MODEL`

Tool to set the filter model in the client state of a sheet. Use when you need to apply or update filter conditions to a dataset's view state. Pass an empty object to clear all filters.

### Set Client State Group Columns

**Slug:** `GIGASHEET_SET_CLIENT_STATE_GROUP_COLUMNS`

Tool to set group columns in the client state of a sheet. Use this to configure which columns are used for grouping data in the sheet view. Column IDs must be letter-based (A, B, C) not numeric.

### Set Client State Sort Model

**Slug:** `GIGASHEET_SET_CLIENT_STATE_SORT_MODEL`

Sets the sort model for a sheet's client state. Use this to programmatically sort data by one or more columns in ascending or descending order. The sort model persists as part of the sheet's view state and can be retrieved later.

### Set Client State Visible Columns

**Slug:** `GIGASHEET_SET_CLIENT_STATE_VISIBLE_COLUMNS`

Tool to set visible columns in the client state of a sheet. Use when you want to control which columns are displayed in the sheet view. If columnIds is empty, all columns will be shown.

### Set Dataset Client State

**Slug:** `GIGASHEET_SET_DATASET_CLIENTSTATE`

Sets the client state of a dataset using a state object. Client state includes view settings like filters, sorts, visible columns, and aggregations. Use this to apply custom view configurations to a dataset programmatically.

### Set Dataset Column Currency

**Slug:** `GIGASHEET_SET_DATASET_COLUMN_CURRENCY`

Tool to set currency format for a dataset column. Use when you need to format numeric data as currency with specific currency codes.

### Set Dataset Note

**Slug:** `GIGASHEET_SET_DATASET_NOTE`

Tool to set or update a note on a dataset in Gigasheet. Use this to add descriptive text, context, or metadata to a dataset for documentation purposes. The note can be up to 20,000 characters long and will be visible when retrieving the dataset metadata.

### Update Dataset Cell

**Slug:** `GIGASHEET_UPDATE_DATASET_CELL`

Tool to update a single cell value in a Gigasheet dataset by column letter and row number. Use after dataset is loaded and when you know the specific column letter (A, B, C, etc.) and row number to update.

### Update Dataset View

**Slug:** `GIGASHEET_UPDATE_DATASET_VIEWS`

Tool to update the client state of a specified view. Use when you need to rename a view or update its client state ID.

### Opt out of shared file

**Slug:** `GIGASHEET_UPDATE_FILE_HANDLE_SHARE_OPT_OUT`

Tool to opt out of a file that has been shared with you. Use when you want to remove a shared file from your shared files list.

### Upsert Rows in Dataset

**Slug:** `GIGASHEET_UPSERT_ROWS`

Tool to upsert rows in an existing Gigasheet dataset. Use when you need to insert or update multiple rows of data starting from a specific column and row position. Overlapping cells will be overwritten with the new values.

### Validate Dataset Formula

**Slug:** `GIGASHEET_VALIDATE_DATASET_FORMULA`

Tool to validate a formula expression against a dataset. Use when you need to check if a formula is syntactically correct and can be applied to the dataset before executing it.

### Validate Files Combine

**Slug:** `GIGASHEET_VALIDATE_FILES_COMBINE`

Tool to validate a combine files request and return all errors that might appear. Use when you need to check if files can be combined before executing the actual combine operation.

### Validate Files Combine by Name

**Slug:** `GIGASHEET_VALIDATE_FILES_COMBINE_BY_NAME`

Tool to validate a combine by name request before executing it. Use when you need to check if multiple files can be combined by matching column names, and identify any potential errors or issues.
