# Turbot Pipes

Turbot Pipes is an intelligence, automation, and security platform built specifically for DevOps, offering hosted Steampipe database instances, shared dashboards, snapshots, and more.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 170
- **Triggers:** 0
- **Slug:** `TURBOT_PIPES`
- **Version:** 20260312_00

## Tools

### Get Authenticated Actor

**Slug:** `TURBOT_PIPES_ACTOR_GET`

Tool to retrieve the authenticated actor. Use when you need details about the currently authenticated actor after obtaining a valid token.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Actor Activity

**Slug:** `TURBOT_PIPES_ACTOR_LIST_ACTIVITY`

Tool to list activities for the authenticated actor. Use when you need detailed activity logs with optional filtering and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of activity records to return. |
| `filter` | string | No | Query to filter actor activities (e.g., 'action_type=token.create'). |
| `next_token` | string | No | Token for fetching the next page of results (from previous response). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List actor connections

**Slug:** `TURBOT_PIPES_ACTOR_LIST_CONNECTIONS`

Tool to list connections associated with the authenticated actor. Use after confirming authentication to retrieve the actor's connection list.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string | No | Filter by connection type |
| `limit` | integer | No | Maximum number of results to return, must be >=1 |
| `offset` | integer | No | Pagination offset, must be >=0 |
| `actorId` | string | No | Filter by actor ID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Actor Organizations

**Slug:** `TURBOT_PIPES_ACTOR_LIST_ORGS`

Tool to list organizations associated with the authenticated actor. Use when you have a valid access token.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Actor Workspaces

**Slug:** `TURBOT_PIPES_ACTOR_LIST_WORKSPACES`

Tool to list workspaces for the authenticated actor. Use when you need to retrieve all workspaces the actor has access to.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Start login via Email

**Slug:** `TURBOT_PIPES_AUTH_LOGIN_TOKEN_EMAIL_CREATE`

Tool to start login process by sending a confirmation code to a user's email. Use when initiating a passwordless email login flow.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | User's email address to receive the login confirmation code |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create User Signup

**Slug:** `TURBOT_PIPES_CREATE_AUTH_SIGNUP`

Tool to create a new user account via signup. Use when registering a new user with their email address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | User's email address for account signup |
| `state` | string | No | Optional state parameter for maintaining state across the signup flow |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create org connection

**Slug:** `TURBOT_PIPES_CREATE_ORG_CONNECTION`

Tool to create a new connection for an organization. Use when you need to establish a new connection with a specific plugin (e.g., AWS, GCP, Azure) in an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string ("available") | No | Mode of the request for creating org connection. |
| `config` | object | No | The plugin or connection configuration |
| `handle` | string | Yes | The handle name for the connection. Must match pattern ^[a-z](?:[a-z0-9]\|_(?=[a-z0-9])){0,38}$ |
| `plugin` | string | Yes | The plugin name for the connection |
| `parent_id` | string | No | The id of the entity where the connection is stored. Can be either tenant, identity, workspace or connection-folder |
| `org_handle` | string | Yes | The handle of the organization where the connection will be created |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Org Connection Folder

**Slug:** `TURBOT_PIPES_CREATE_ORG_CONNECTION_FOLDER`

Tool to create a new connection folder for an organization. Use when you need to create a connection folder in an org to organize connections.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string ("available") | No | Mode enum for the request. |
| `title` | string | Yes | The title of the connection folder. Must match pattern: ^[a-z](?:[a-z0-9]\|_(?=[a-z0-9])){0,38}$ |
| `parent_id` | string | No | The id of the parent entity where the connection folder will be created. |
| `org_handle` | string | Yes | The handle of the org for which we want to create a connection folder. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Org Workspace Aggregator

**Slug:** `TURBOT_PIPES_CREATE_ORG_WORKSPACE_AGGREGATOR`

Tool to create an aggregator for a workspace of an organization. Use when you need to add a new aggregator to a specific organization's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `config` | object | No | The configuration for the aggregator |
| `handle` | string | Yes | The handle of the aggregator. Must start with a lowercase letter, followed by lowercase letters, numbers, or underscores, up to 39 characters total |
| `plugin` | string | Yes | Plugin name for the aggregator (e.g., 'aws', 'gcp', 'azure') |
| `org_handle` | string | Yes | The handle of the organization to which the workspace belongs |
| `connections` | array | No | The connections that are a part of the aggregator |
| `workspace_handle` | string | Yes | The handle of the workspace where the aggregator will be created |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Org Workspace Connection

**Slug:** `TURBOT_PIPES_CREATE_ORG_WORKSPACE_CONNECTION`

Tool to create a connection on an org workspace or associate an existing org connection to the workspace. Use when you need to create or link a connection to an organization's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `config` | object | No | The plugin or connection configuration |
| `handle` | string | Yes | The handle for the connection. Must match pattern: ^[a-z](?:[a-z0-9]\|_(?=[a-z0-9])){0,38}$ |
| `plugin` | string | Yes | The plugin name for the connection |
| `parent_id` | string | No | The id of the parent entity where the connection will be stored |
| `org_handle` | string | Yes | The handle of the organization to which the workspace belongs to |
| `workspace_handle` | string | Yes | The handle of the workspace where the connection will be created or associated |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Org Workspace Connection Folder

**Slug:** `TURBOT_PIPES_CREATE_ORG_WORKSPACE_CONNECTION_FOLDER`

Tool to create a connection folder in a workspace of an organization. Use when you need to organize connections into folders within an org workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string ("available") | No | Mode for the request. |
| `title` | string | Yes | The title of the connection folder. Must start with a lowercase letter, followed by lowercase letters, numbers, or underscores, up to 39 characters total |
| `parent_id` | string | No | The ID of the parent folder where this connection folder will be created |
| `org_handle` | string | Yes | The handle of the organization where the connection folder will be created |
| `workspace_handle` | string | Yes | The handle of the workspace where the connection folder will be created |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Org Workspace Query

**Slug:** `TURBOT_PIPES_CREATE_ORG_WORKSPACE_QUERY`

Tool to execute a SQL query in an org workspace using POST method. Use when you need to run queries against Turbot Pipes workspaces. Results are limited to 5000 rows or 30 seconds of execution time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sql` | string | Yes | SQL query to execute against the workspace. Results are limited to 5000 rows or 30 seconds of query execution |
| `org_handle` | string | Yes | The handle of the organization |
| `workspace_handle` | string | Yes | The handle of the workspace |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Org Workspace Snapshot

**Slug:** `TURBOT_PIPES_CREATE_ORG_WORKSPACE_SNAPSHOT`

Tool to create a new workspace snapshot for an organization. Use when you need to save a point-in-time capture of dashboard data, layouts, and panels for a workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | The snapshot data containing layout, panels, and time range information. |
| `tags` | object | No | Optional tags to categorize or label the snapshot. |
| `title` | string | No | Optional title for the snapshot. |
| `org_handle` | string | Yes | The handle of the organization where the workspace exists. |
| `visibility` | string ("workspace" | "anyone_with_link") | No | Visibility options for workspace snapshots. |
| `workspace_handle` | string | Yes | The handle of the workspace to create the snapshot for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create User AI Key

**Slug:** `TURBOT_PIPES_CREATE_USER_AI_KEY`

Tool to create a new AI provider API key at the user level. Use when you need to configure AI provider credentials for a specific user in Turbot Pipes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `api_key` | string | Yes | The API key from the AI provider (e.g., OpenAI or Anthropic) |
| `provider` | string ("openai" | "anthropic") | Yes | The AI provider for this API key |
| `user_handle` | string | Yes | The handle of the user for which the AI key is being created |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create User Connection

**Slug:** `TURBOT_PIPES_CREATE_USER_CONNECTION`

Tool to create a new connection for a user. Use when you need to establish a new connection with a specific plugin (e.g., AWS, GCP, Azure) for a user account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string ("available") | No | Mode of the request for creating user connection. |
| `config` | object | No | The plugin or connection configuration |
| `handle` | string | Yes | The handle name for the connection. Must match pattern ^[a-z](?:[a-z0-9]\|_(?=[a-z0-9])){0,38}$ |
| `plugin` | string | Yes | The plugin name for the connection |
| `parent_id` | string | No | The id of the entity where the connection is stored. Can be either tenant, identity, workspace or connection-folder |
| `user_handle` | string | Yes | The handle of the user where we want to create the connection |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create User Integration

**Slug:** `TURBOT_PIPES_CREATE_USER_INTEGRATION`

Tool to create a new integration for a user. Use when you need to create a new integration for a specific user by providing the user handle, integration handle, and type.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("aws" | "azure" | "gcp" | "github" | "slack" | "gitlab") | Yes | The type of the integration, can be one of aws, azure, gcp, gitlab, slack or github |
| `config` | object | No | The configuration for the integration |
| `handle` | string | Yes | The handle for the integration |
| `user_handle` | string | Yes | The handle of the user for which you want to create an integration |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create User Notifier

**Slug:** `TURBOT_PIPES_CREATE_USER_NOTIFIER`

Tool to create a new notifier for a user. Use when you need to configure notification endpoints for a specific user in Turbot Pipes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The name of the notifier to create. Must match pattern: ^[a-z](?:[a-z0-9]\|_(?=[a-z0-9])){0,38}$ (lowercase letters, numbers, underscores, max 39 chars) |
| `state` | string ("enabled" | "disabled") | Yes | The state of the notifier (enabled or disabled) |
| `notifies` | array | Yes | List of notify targets for the notifier. Each target specifies an integration handle and type |
| `user_handle` | string | Yes | The handle of the user for which the notifier is being created |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create User Password

**Slug:** `TURBOT_PIPES_CREATE_USER_PASSWORD`

Tool to create or rotate a user password. Use when you need to generate a new password for a user or reset an existing one.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | Handle of the user whose password needs to be created or rotated |
| `expires_in_minutes` | integer | No | Number of minutes until the password expires. If not specified, password may not expire or uses system default |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create User Workspace Connection

**Slug:** `TURBOT_PIPES_CREATE_USER_WORKSPACE_CONNECTION`

Tool to create a connection on a workspace for a user. Use when you need to create or link a connection to a user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `config` | object | No | The plugin or connection configuration |
| `handle` | string | Yes | The handle for the connection. Must match pattern: ^[a-z0-9][a-z0-9-]{1,37}[a-z0-9]$ |
| `plugin` | string | Yes | The plugin name for the connection |
| `parent_id` | string | No | The id of the parent entity where the connection will be stored |
| `user_handle` | string | Yes | The handle of the user who owns the workspace |
| `workspace_handle` | string | Yes | The handle of the workspace where the connection will be created |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create User Workspace Connection Folder

**Slug:** `TURBOT_PIPES_CREATE_USER_WORKSPACE_CONNECTION_FOLDER`

Tool to create a connection folder in a workspace of a user. Use when you need to organize connections into folders within a user workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | Yes | The title of the connection folder. Must start with a lowercase letter, followed by lowercase letters, numbers, or underscores, up to 39 characters total |
| `parent_id` | string | No | The ID of the parent folder where this connection folder will be created |
| `user_handle` | string | Yes | The handle of the user where the connection folder will be created |
| `workspace_handle` | string | Yes | The handle of the workspace where the connection folder will be created |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create User Workspace Datatank

**Slug:** `TURBOT_PIPES_CREATE_USER_WORKSPACE_DATATANK`

Tool to create a new user workspace Datatank. Use when you need to create a new Datatank for data storage in a user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `handle` | string | Yes | The handle name for the datatank. Must match pattern ^[A-Za-z_][A-Za-z_0-9$]*$ |
| `description` | string | No | Description of the datatank. |
| `user_handle` | string | Yes | The handle of the user where we want to create the workspace Datatank. |
| `desired_state` | string ("enabled" | "disabled") | No | Desired state for the datatank. |
| `workspace_handle` | string | Yes | The handle of the workspace. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create User Workspace Datatank Table

**Slug:** `TURBOT_PIPES_CREATE_USER_WORKSPACE_DATATANK_TABLE`

Tool to create a new user workspace datatank table. Use when you need to create a table within a user's workspace datatank for data storage and querying.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The name of the table. Must match pattern ^[A-Za-z_][A-Za-z_0-9$]*$ |
| `type` | string ("table" | "query") | Yes | The type of the table, either 'table' or 'query'. |
| `part_per` | string ("connection") | No | Partition strategy for the datatank table. |
| `frequency` | object | Yes | The frequency configuration for refreshing the table. |
| `description` | string | No | Description of the datatank table. |
| `user_handle` | string | Yes | The handle of the user where we want to create the workspace Datatank table. |
| `source_query` | string | No | The SQL query to populate the table. Required when type is 'query'. |
| `source_table` | string | No | The source table name. Used when type is 'table'. |
| `desired_state` | string ("enabled" | "disabled") | No | Desired state of the datatank table. |
| `source_schema` | string | No | The source schema name. Used when type is 'table'. |
| `datatank_handle` | string | Yes | The name of the Datatank. |
| `workspace_handle` | string | Yes | The handle of the workspace. |
| `skip_initial_refresh` | boolean | No | Whether to skip the initial refresh of the table. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create User Workspace Mod Variable Setting

**Slug:** `TURBOT_PIPES_CREATE_USER_WORKSPACE_MOD_VARIABLE_SETTING`

Tool to create a setting for a mod variable in a user workspace. Use when you need to configure a variable for a mod installed in a user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The name of the variable to create the setting for |
| `setting` | string | Yes | The setting value for the variable (can be string, number, boolean, object, or array) |
| `mod_alias` | string | Yes | The mod alias or mod ID for which the variable setting is to be created |
| `user_handle` | string | Yes | The handle of the user who owns the workspace |
| `workspace_handle` | string | Yes | The handle of the workspace where the mod is installed |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create User Workspace Notifier

**Slug:** `TURBOT_PIPES_CREATE_USER_WORKSPACE_NOTIFIER`

Tool to create a new notifier for a user workspace. Use when you need to configure a notification endpoint (e.g., Slack, email) for a specific workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The name of the notifier to create. Must start with a lowercase letter, followed by lowercase alphanumeric characters or underscores (max 39 characters) |
| `state` | string ("enabled" | "disabled") | No | State of the notifier. |
| `notifies` | array | Yes | The notify targets for the notifier to create |
| `user_handle` | string | Yes | The handle of the user for which the notifier is to be created |
| `workspace_handle` | string | Yes | The handle of the workspace for which the notifier is to be created |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Org Workspace Conversation

**Slug:** `TURBOT_PIPES_DELETE_CONVERSATION_ORG`

Tool to delete a specific org workspace conversation. Use when you need to remove an AI conversation from an organization workspace after confirming the org handle, workspace handle, and conversation ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_handle` | string | Yes | The handle of the organization that owns the workspace |
| `conversation_id` | string | Yes | The ID of the conversation to delete |
| `workspace_handle` | string | Yes | The handle of the org workspace |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Organization

**Slug:** `TURBOT_PIPES_DELETE_ORG`

Tool to delete a specified organization if you have appropriate access. Use when you need to permanently remove an organization and have confirmed the org handle.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_handle` | string | Yes | Specify the handle of the organization which need to be deleted |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Org Billing Subscription

**Slug:** `TURBOT_PIPES_DELETE_ORG_BILLING_SUBSCRIPTION`

Tool to delete an organization billing subscription. Schedules cancellation at the end of the current period. Use when you need to cancel an org subscription after confirming the org handle and subscription ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_handle` | string | Yes | The handle of the organization whose subscription will be deleted |
| `subscription_id` | string | Yes | The org subscription id to be deleted |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Org Connection Permission

**Slug:** `TURBOT_PIPES_DELETE_ORG_CONNECTION_PERMISSION`

Tool to delete permission for a connection defined on an org. Use when you need to revoke a specific permission from an org connection.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_handle` | string | Yes | The handle of the org for which we want to delete connection permission for |
| `permission_id` | string | Yes | The id of the permission which we want to delete |
| `connection_handle` | string | Yes | The handle of the connection for which we want to delete permission for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Organization Workspace

**Slug:** `TURBOT_PIPES_DELETE_ORG_WORKSPACE`

Tool to delete an organization workspace. Use when you need to permanently remove a workspace from an organization after confirming org and workspace handles.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_handle` | string | Yes | The handle of the organization where the workspace exists |
| `workspace_handle` | string | Yes | The handle of the workspace to be deleted |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Org Workspace Mod Variable Setting

**Slug:** `TURBOT_PIPES_DELETE_ORG_WORKSPACE_MOD_VARIABLE_SETTING`

Tool to delete setting for a mod variable in an organization workspace. Use when you need to remove a custom setting for a mod variable in a specific workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mod_alias` | string | Yes | The mod alias or mod ID which contains the variable |
| `org_handle` | string | Yes | The handle of the organization that owns the workspace |
| `variable_name` | string | Yes | The name of the variable to delete the setting for |
| `workspace_handle` | string | Yes | The handle of the workspace where the mod was installed |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete User Avatar

**Slug:** `TURBOT_PIPES_DELETE_USER_AVATAR`

Tool to delete custom avatar for a user. Use when you need to remove a user's custom avatar and revert to default.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | Handle or identifier of the user whose avatar will be deleted |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete User Connection (Deprecated)

**Slug:** `TURBOT_PIPES_DELETE_USER_CONNECTION_DEPRECATED`

Tool to delete a connection belonging to a user (deprecated endpoint). Use when you need to remove a user's connection after confirming the user handle and connection handle. Returns the deleted connection details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `conn_handle` | string | Yes | The handle of the connection that needs to be deleted |
| `user_handle` | string | Yes | The handle of the user where the connection exists |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete User Integration

**Slug:** `TURBOT_PIPES_DELETE_USER_INTEGRATION`

Tool to delete an integration configured for a user. Use when you need to remove a user's integration by providing the user handle and integration handle.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | The handle identifying the user whose integration is configured |
| `integration_handle` | string | Yes | The handle identifying the integration to be removed |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete User Workspace Mod Variable Setting

**Slug:** `TURBOT_PIPES_DELETE_USER_WORKSPACE_MOD_VARIABLE_SETTING`

Tool to delete a mod variable setting in a user workspace. Use when you need to remove a variable configuration from a mod installed in a user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mod_alias` | string | Yes | The mod alias or mod ID for which the variable setting is to be deleted |
| `user_handle` | string | Yes | The handle of the user who owns the workspace |
| `variable_name` | string | Yes | The name of the variable to delete the setting for |
| `workspace_handle` | string | Yes | The handle of the workspace where the mod was installed |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete User Workspace Notifier

**Slug:** `TURBOT_PIPES_DELETE_USER_WORKSPACE_NOTIFIER`

Tool to delete a notifier for a user workspace. Use when you need to remove a notification configuration from a specific workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | The handle of the user for which the notifier is to be deleted |
| `notifier_name` | string | Yes | The name of the notifier to be deleted |
| `workspace_handle` | string | Yes | The handle of the workspace for which the notifier is to be deleted |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete User Workspace Pipeline

**Slug:** `TURBOT_PIPES_DELETE_USER_WORKSPACE_PIPELINE`

Tool to delete a pipeline from a user's workspace. Use when you need to remove a specific pipeline by its ID from a workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pipeline_id` | string | Yes | Provide the id of the pipeline which needs to be deleted. |
| `user_handle` | string | Yes | The handle of the user which contains the workspace. |
| `workspace_handle` | string | Yes | The handle of the workspace where the pipeline exists. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Auth Provider

**Slug:** `TURBOT_PIPES_GET_AUTH_PROVIDER`

Tool to initiate OAuth authentication flow with a provider. Use when you need to start the OAuth authorization process for GitHub, Google, or SAML authentication.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `provider` | string ("github" | "google" | "saml") | Yes | Authentication provider name (github, google, or saml). This will initiate an OAuth authorization flow with the specified provider. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Workspace Conversation

**Slug:** `TURBOT_PIPES_GET_CONVERSATION_USER`

Tool to retrieve details for a specific user workspace conversation. Use when you need to get information about an AI conversation in a user workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | The handle of the user that owns the workspace |
| `conversation_id` | string | Yes | The ID of the conversation to retrieve |
| `workspace_handle` | string | Yes | The handle of the user workspace |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Datatank Table

**Slug:** `TURBOT_PIPES_GET_DATATANK_TABLE`

Tool to get the details for a workspace Datatank table. Use when you need to retrieve information about a specific datatank table including its state, configuration, and metadata.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_handle` | string | Yes | The handle of the organization or user (identity handle) |
| `datatank_handle` | string | Yes | The handle of the datatank |
| `workspace_handle` | string | Yes | The handle of the workspace |
| `datatank_table_name` | string | Yes | The name of the datatank table |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization

**Slug:** `TURBOT_PIPES_GET_ORG`

Tool to retrieve organization information by handle. Use when you need details about a specific organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_handle` | string | Yes | Specify the handle of an organization whose information you want to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization Billing Invoice

**Slug:** `TURBOT_PIPES_GET_ORG_BILLING_INVOICE`

Tool to get an invoice for an organization. Use when you need to retrieve detailed billing invoice information for a specific organization and invoice ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | The unique identifier of the invoice (Stripe invoice ID format) |
| `org_handle` | string | Yes | The handle of the organization |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Org Connection Permission

**Slug:** `TURBOT_PIPES_GET_ORG_CONNECTION_PERMISSION`

Tool to retrieve permission details for an org connection. Use when you need to view a specific permission record for a connection within an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_handle` | string | Yes | The handle of the org for which to get connection permission. |
| `permission_id` | string | Yes | The ID of the permission to retrieve. |
| `connection_handle` | string | Yes | The handle of the connection for which to get permission. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization Integration

**Slug:** `TURBOT_PIPES_GET_ORG_INTEGRATION`

Tool to get details of an integration configured on an organization. Use when you need to retrieve information about a specific integration by its handle and organization handle.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_handle` | string | Yes | The handle of the org to which the integration belongs to. |
| `integration_handle` | string | Yes | The handle of the integration whose details need to be retrieved. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization Member

**Slug:** `TURBOT_PIPES_GET_ORG_MEMBER`

Tool to retrieve a specific organization member by org handle and user handle. Use when you need details about a specific member of an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_handle` | string | Yes | The handle of the organization |
| `user_handle` | string | Yes | The handle of the user/member to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Org Workspace Connection

**Slug:** `TURBOT_PIPES_GET_ORG_WORKSPACE_CONNECTION`

Tool to get the details for a workspace and connection association on an organization. Use when you need to retrieve information about how a connection is associated with a specific workspace in an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_handle` | string | Yes | The handle of the org for which you want to get the association |
| `workspace_handle` | string | Yes | The handle of the workspace where the connection exists |
| `connection_handle` | string | Yes | The handle of the connection whose association details needs to be fetched |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Org Workspace Connection Folder

**Slug:** `TURBOT_PIPES_GET_ORG_WORKSPACE_CONNECTION_FOLDER`

Tool to retrieve a connection folder for an organization workspace. Use when you need to get details about a specific connection folder in an org workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `folder_id` | string | Yes | The id of the connection folder to retrieve. |
| `org_handle` | string | Yes | The handle of the organization where the folder exists. |
| `workspace_handle` | string | Yes | The handle of the workspace where the folder exists. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Org Workspace Flowpipe Trigger

**Slug:** `TURBOT_PIPES_GET_ORG_WORKSPACE_FLOWPIPE_TRIGGER`

Tool to get the details of a trigger for a workspace in an organization. Use when you need to retrieve information about a specific Flowpipe trigger.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_handle` | string | Yes | The handle of the organization which contains the workspace. |
| `trigger_name` | string | Yes | The name of the flowpipe trigger whose details needs to be fetched. |
| `workspace_handle` | string | Yes | The handle of the workspace where the trigger exists. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Org Workspace Integration

**Slug:** `TURBOT_PIPES_GET_ORG_WORKSPACE_INTEGRATION`

Tool to get details of an integration available for a workspace belonging to an organization. Use when you need to retrieve information about a specific integration configured for a workspace within an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_handle` | string | Yes | The handle of the organization to which the workspace belongs |
| `workspace_handle` | string | Yes | The handle of the workspace for which you want to get integration details |
| `integration_handle` | string | Yes | The handle of the integration to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Org Workspace Mod Variable Setting

**Slug:** `TURBOT_PIPES_GET_ORG_WORKSPACE_MOD_VARIABLE_SETTING`

Tool to get setting for a mod variable in an organization workspace. Use when you need to retrieve the current configuration and value of a specific mod variable in a workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mod_alias` | string | Yes | The mod alias or mod ID which contains the variable |
| `org_handle` | string | Yes | The handle of the organization that owns the workspace |
| `variable_name` | string | Yes | The name of the variable to retrieve the setting for |
| `workspace_handle` | string | Yes | The handle of the workspace where the mod is installed |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Org Workspace Notifier

**Slug:** `TURBOT_PIPES_GET_ORG_WORKSPACE_NOTIFIER`

Tool to retrieve a notifier from an org workspace. Use when you need to get details about a specific notification endpoint configured for an organization's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_handle` | string | Yes | Handle of the organization |
| `notifier_name` | string | Yes | Name of the notifier to retrieve |
| `workspace_handle` | string | Yes | Handle of the workspace within the organization |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Org Workspace Query Data

**Slug:** `TURBOT_PIPES_GET_ORG_WORKSPACE_QUERY_DATA`

Tool to execute a SQL query in an org workspace and retrieve results. Use when you need to run queries against Turbot Pipes workspaces. Results are limited to 5000 rows or 30 seconds of execution time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sql` | string | Yes | SQL query to execute against the workspace. Results are limited to 5000 rows or 30 seconds of query execution |
| `extensions` | string ("json" | "csv" | "md") | Yes | Output format extension - determines response content type (json, csv, or md) |
| `org_handle` | string | Yes | The handle of the organization |
| `workspace_handle` | string | Yes | The handle of the workspace |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Tenant

**Slug:** `TURBOT_PIPES_GET_TENANT`

Tool to retrieve tenant information by handle. Use when you need details about a specific tenant.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tenant_handle` | string | Yes | Specify the handle of a tenant whose information you want to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Tenant Avatar

**Slug:** `TURBOT_PIPES_GET_TENANT_AVATAR`

Tool to retrieve public avatar image for a tenant. Use when you need to display or download the tenant's avatar.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tenant_handle` | string | Yes | The handle of the tenant to retrieve the avatar for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User

**Slug:** `TURBOT_PIPES_GET_USER`

Tool to retrieve user information by handle. Use when you need details about a specific user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | Specify the handle of the user whose information you want to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User AI Key

**Slug:** `TURBOT_PIPES_GET_USER_AI_KEY`

Tool to retrieve AI provider API key metadata at the user level. Use when you need to check which AI provider keys are configured for a specific user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `provider` | string ("openai" | "anthropic") | Yes | AI provider for which to retrieve the key (openai or anthropic) |
| `user_handle` | string | Yes | Handle of the user that owns the AI key |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Billing Plan

**Slug:** `TURBOT_PIPES_GET_USER_BILLING_PLAN`

Tool to get the current user billing plan. Use when you need to retrieve detailed billing plan information for a specific user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | The handle of the user whose billing plan to retrieve. Can be obtained from the GET /actor endpoint. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Billing Upcoming Invoice

**Slug:** `TURBOT_PIPES_GET_USER_BILLING_UPCOMING_INVOICE`

Tool to get the upcoming invoice for a user. Use when you need to retrieve the estimated next invoice for a user's billing cycle. Returns null when no upcoming invoice exists.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | The handle of the user to retrieve the upcoming invoice for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Connection

**Slug:** `TURBOT_PIPES_GET_USER_CONNECTION`

Tool to retrieve details of a connection belonging to a user. Use when you need to fetch information about a specific user connection by user handle and connection handle.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | The handle of the user who owns the connection |
| `connection_handle` | string | Yes | The handle of the connection to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Email

**Slug:** `TURBOT_PIPES_GET_USER_EMAIL`

Tool to retrieve a specific user email record with metadata. Use when you need details about a user's email verification status and metadata.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email_id` | string | Yes | Specify the id of the email object you want to retrieve. |
| `user_handle` | string | Yes | Specify the handle of the user whose email information you want to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Integration

**Slug:** `TURBOT_PIPES_GET_USER_INTEGRATION`

Tool to get details of an integration configured on a user. Use when you need to retrieve information about a specific user integration by providing the user handle and integration handle.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | The handle of the user to which the integration belongs to. |
| `integration_handle` | string | Yes | The handle of the integration whose details need to be retrieved. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Database Password

**Slug:** `TURBOT_PIPES_GET_USER_PASSWORD`

Tool to retrieve user database password. Use when you need to get the database password for a specific user by their handle.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | Specify the handle of the user whose password need to be retrieved |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Preferences

**Slug:** `TURBOT_PIPES_GET_USER_PREFERENCES`

Tool to retrieve user preferences including email subscription settings. Use when you need to check a user's communication preferences.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | Specify the handle of the user whose preferences need to be retrieved. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Process

**Slug:** `TURBOT_PIPES_GET_USER_PROCESS`

Tool to retrieve process information for a user. Use when you need details about a specific process associated with a user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `process_id` | string | Yes | The unique identifier of the process to retrieve. |
| `user_handle` | string | Yes | The handle of the user whose process you want to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Workspace

**Slug:** `TURBOT_PIPES_GET_USER_WORKSPACE`

Tool to retrieve workspace details for a specific user. Use when you need information about a workspace owned by a user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | The handle of the user where the workspace exists. |
| `workspace_handle` | string | Yes | The handle of the workspace whose details need to be fetched. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Workspace Aggregator

**Slug:** `TURBOT_PIPES_GET_USER_WORKSPACE_AGGREGATOR`

Tool to get the details of an aggregator belonging to a workspace of a user. Use when you need to retrieve information about a specific aggregator in a user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | The handle of the user to which the workspace belongs |
| `workspace_handle` | string | Yes | The handle of the workspace where the aggregator exists |
| `aggregator_handle` | string | Yes | The handle of the aggregator to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Workspace Connection

**Slug:** `TURBOT_PIPES_GET_USER_WORKSPACE_CONNECTION`

Tool to get the details for a workspace and connection association for a user. Use when you need to retrieve information about how a connection is associated with a specific workspace owned by a user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | The handle of the user for which you want to get the association |
| `workspace_handle` | string | Yes | The handle of the workspace where the association exists |
| `connection_handle` | string | Yes | The handle of the connection whose association details needs to be fetched |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Workspace Connection Folder

**Slug:** `TURBOT_PIPES_GET_USER_WORKSPACE_CONNECTION_FOLDER`

Tool to retrieve a connection folder for a user workspace. Use when you need to get details about a specific connection folder in a user workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `folder_id` | string | Yes | The id of the connection folder to retrieve. |
| `user_handle` | string | Yes | The handle of the user where the folder exists. |
| `workspace_handle` | string | Yes | The handle of the workspace where the folder exists. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Workspace Datatank

**Slug:** `TURBOT_PIPES_GET_USER_WORKSPACE_DATATANK`

Tool to retrieve user workspace datatank details. Use when you need information about a specific datatank within a user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | The handle of the user. |
| `datatank_handle` | string | Yes | The name of the workspace Datatank. |
| `workspace_handle` | string | Yes | The handle of the workspace. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Workspace Flowpipe Mod

**Slug:** `TURBOT_PIPES_GET_USER_WORKSPACE_FLOWPIPE_MOD`

Tool to retrieve details of an installed flowpipe mod in a user workspace. Use when you need information about a specific flowpipe mod installed in a workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mod_alias` | string | Yes | The mod alias or mod ID |
| `user_handle` | string | Yes | The handle of the user who owns the workspace. |
| `workspace_handle` | string | Yes | Provide the handle of the workspace where mod was installed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Workspace Flowpipe Pipeline

**Slug:** `TURBOT_PIPES_GET_USER_WORKSPACE_FLOWPIPE_PIPELINE`

Tool to retrieve pipeline details for a user workspace. Use when you need detailed information about a specific Flowpipe pipeline in a user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pipeline_id` | string | Yes | The id of the pipeline whose detail needs to be fetched. |
| `user_handle` | string | Yes | The handle of the user which contains the workspace. |
| `workspace_handle` | string | Yes | The handle of the workspace where the pipeline exists. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Workspace Integration

**Slug:** `TURBOT_PIPES_GET_USER_WORKSPACE_INTEGRATION`

Tool to get details of an integration available for a workspace belonging to a user. Use when you need to retrieve information about a specific integration configured for a user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | The handle of the user to which the workspace belongs to. |
| `workspace_handle` | string | Yes | The handle of the workspace for which we want to get the integration details. |
| `integration_handle` | string | Yes | The handle of the integration whose details need to be retrieved. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Workspace Mod

**Slug:** `TURBOT_PIPES_GET_USER_WORKSPACE_MOD`

Tool to retrieve details of an installed mod in a user's workspace. Use when you need information about a specific mod installed in a workspace owned by a user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mod_alias` | string | Yes | The mod alias or mod ID to retrieve. |
| `user_handle` | string | Yes | The handle of the user who owns the workspace. |
| `workspace_handle` | string | Yes | The handle of the workspace where the mod is installed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Workspace Mod Variable Setting

**Slug:** `TURBOT_PIPES_GET_USER_WORKSPACE_MOD_VARIABLE_SETTING`

Tool to get setting for a mod variable in a user workspace. Use when you need to retrieve the current configuration and value of a specific mod variable in a user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mod_alias` | string | Yes | The mod alias or mod ID for which the variable setting belongs to |
| `user_handle` | string | Yes | The handle of the user who owns the workspace |
| `variable_name` | string | Yes | The name of the variable to get the setting for |
| `workspace_handle` | string | Yes | The handle of the workspace where the mod was installed |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Workspace Notifier

**Slug:** `TURBOT_PIPES_GET_USER_WORKSPACE_NOTIFIER`

Tool to retrieve a notifier from a user workspace. Use when you need to get details about a specific notification endpoint configured for a user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | The handle of the user for which the notifier is to be retrieved. |
| `notifier_name` | string | Yes | The name of the notifier to be retrieved. |
| `workspace_handle` | string | Yes | The handle of the workspace for which the notifier is to be retrieved. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Workspace Pipeline

**Slug:** `TURBOT_PIPES_GET_USER_WORKSPACE_PIPELINE`

Tool to get the details of a pipeline for a workspace of a user. Use when you need information about a specific pipeline in a user workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pipeline_id` | string | Yes | The unique identifier of the pipeline to retrieve. |
| `user_handle` | string | Yes | The handle of the user where the workspace exists. |
| `workspace_handle` | string | Yes | The handle of the workspace where the pipeline exists. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Workspace Process

**Slug:** `TURBOT_PIPES_GET_USER_WORKSPACE_PROCESS`

Tool to retrieve process details for a user workspace. Use when you need information about a specific process running in a user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `process_id` | string | Yes | The unique identifier of the process to be fetched. |
| `user_handle` | string | Yes | The handle of the user where the workspace exists. |
| `workspace_handle` | string | Yes | The handle of the workspace whose process needs to be fetched. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Workspace Process Log

**Slug:** `TURBOT_PIPES_GET_USER_WORKSPACE_PROCESS_LOG`

Tool to retrieve process logs for a user workspace process. Use when you need to fetch and analyze logs for a specific process running in a user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `log_file` | string ("process") | Yes | The process log file to fetch (currently only 'process' is supported) |
| `process_id` | string | Yes | The unique identifier of the process |
| `user_handle` | string | Yes | The handle of the user where the workspace exists |
| `content_type` | string ("jsonl") | Yes | The content type format for the log file (currently only 'jsonl' is supported) |
| `workspace_handle` | string | Yes | The handle of the workspace where the process is running |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Workspace Query

**Slug:** `TURBOT_PIPES_GET_USER_WORKSPACE_QUERY`

Tool to execute a SQL query in a user workspace and retrieve results. Use when you need to run queries against Turbot Pipes user workspaces. Results are limited to 5000 rows or 30 seconds of execution time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sql` | string | Yes | The SQL query to execute against the workspace. Results are limited to 5000 rows or 30 seconds of query execution |
| `user_handle` | string | Yes | The handle of the user |
| `content_type` | string ("application/json" | "text/csv" | "text/markdown") | No | Supported content types for query response format. |
| `workspace_handle` | string | Yes | The handle of the workspace |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Workspace Query Data

**Slug:** `TURBOT_PIPES_GET_USER_WORKSPACE_QUERY_DATA`

Tool to execute a SQL query in a user workspace and retrieve results. Use when you need to run queries against Turbot Pipes user workspaces. Results are limited to 5000 rows or 30 seconds of execution time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sql` | string | Yes | SQL query to execute against the workspace. Results are limited to 5000 rows or 30 seconds of query execution |
| `extensions` | string ("json" | "csv" | "md") | Yes | Output format extension - determines response content type (json, csv, or md) |
| `user_handle` | string | Yes | The handle of the user |
| `workspace_handle` | string | Yes | The handle of the workspace |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Workspace Schema

**Slug:** `TURBOT_PIPES_GET_USER_WORKSPACE_SCHEMA`

Tool to retrieve workspace schema details for a specific user. Use when you need information about a specific schema within a user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `schema_name` | string | Yes | The name of the schema whose detail needs to be fetched |
| `user_handle` | string | Yes | The handle of the user that the workspace belongs to |
| `workspace_handle` | string | Yes | The handle of the workspace where the schema exists |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Workspace Schema Table

**Slug:** `TURBOT_PIPES_GET_USER_WORKSPACE_SCHEMA_TABLE`

Tool to get details about a specific table in a user workspace schema. Use when you need information about table structure, columns, and metadata within a user's workspace schema.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `table_name` | string | Yes | The name of the table whose detail needs to be fetched. |
| `schema_name` | string | Yes | The name of the schema to which the table belongs. |
| `user_handle` | string | Yes | The handle of the user that the workspace belongs to. |
| `workspace_handle` | string | Yes | The handle of the workspace where the schema exists. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Identity

**Slug:** `TURBOT_PIPES_IDENTITIES_GET`

Tool to retrieve a specific identity by handle. Use when you need details of an identity by its handle after authenticating.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `identity_handle` | string | Yes | Unique identifier for the identity to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Identity Avatar

**Slug:** `TURBOT_PIPES_IDENTITIES_GET_AVATAR`

Tool to retrieve avatar image for an identity. Use when you need to display or download the user's avatar after knowing their identity handle.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `identity_handle` | string | Yes | Handle or ID of the identity for which to retrieve the avatar image |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Identities

**Slug:** `TURBOT_PIPES_IDENTITIES_LIST`

Tool to list all identities. Use when you need to retrieve identities with optional filtering, sorting, and pagination after authentication.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | No | Search query to filter identities by display name or handle. |
| `limit` | integer | No | Maximum number of identities to return per page (1-100). |
| `next_token` | string | No | Token for pagination to retrieve the next page of results. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Initiate User Login

**Slug:** `TURBOT_PIPES_INITIATE_LOGIN`

Tool to initiate user login. Use when starting a login flow for a user with their email address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | User's email address to initiate login |
| `state` | string | No | Optional state parameter for maintaining state across the login flow |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Install User Slack Integration

**Slug:** `TURBOT_PIPES_INSTALL_USER_INTEGRATION_SLACK`

Tool to install a Slack integration for a user identity. Use when you need to initiate the Slack OAuth flow by redirecting to the Slack authorization URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | The handle of the user to which the integration belongs to. |
| `integration_handle` | string | Yes | The handle of the Slack integration which needs to be installed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Install User Workspace Flowpipe Mod

**Slug:** `TURBOT_PIPES_INSTALL_USER_WORKSPACE_FLOWPIPE_MOD`

Tool to install a flowpipe mod to a user's workspace. Use when you need to install a flowpipe mod from a repository path into a specific user workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | Yes | The path to the flowpipe mod (e.g., github.com/turbot/flowpipe-mod-aws) |
| `branch` | string | No | Git branch to install from |
| `version` | string | No | Specific version to install |
| `constraint` | string | No | Version constraint for the mod (e.g., '^1.0.0', '*', 'latest') |
| `user_handle` | string | Yes | The handle of the user who owns the workspace |
| `workspace_handle` | string | Yes | The handle of the workspace where the mod will be installed |
| `integration_handle` | string | No | Handle of the integration to use for authentication |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Install User Workspace Mod

**Slug:** `TURBOT_PIPES_INSTALL_USER_WORKSPACE_MOD`

Tool to install a mod to a user workspace. Use when you need to add a new mod from a repository path to a specific workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | Yes | The path to the mod repository (e.g., github.com/turbot/steampipe-mod-azure-compliance). |
| `user_handle` | string | Yes | The handle of the user who owns the workspace. |
| `workspace_handle` | string | Yes | The handle of the workspace where the mod will be installed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Organization Processes

**Slug:** `TURBOT_PIPES_LIST_ORG_PROCESS`

Tool to list processes for an organization. Use when you need to retrieve all processes for a specific organization with optional pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of processes to return per page (1-100). |
| `next_token` | string | No | Token for pagination to retrieve the next page of results. |
| `org_handle` | string | Yes | The handle of the organization to list processes for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Organization Service Accounts

**Slug:** `TURBOT_PIPES_LIST_ORG_SERVICE_ACCOUNTS`

Tool to list service accounts at the organization level. Use when you need to retrieve all service accounts for a specific organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not specified will default to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. |
| `org_handle` | string | Yes | The handle of the organization |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Organization Usage

**Slug:** `TURBOT_PIPES_LIST_ORG_USAGE`

Tool to list all usage metrics for an organization. Use when you need to retrieve usage data for billing, monitoring, or analytics purposes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of usage records to return per page |
| `next_token` | string | No | Token for fetching the next page of results (from previous response) |
| `org_handle` | string | Yes | The handle of the organization whose usage metrics you want to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Org Workspace Datatank

**Slug:** `TURBOT_PIPES_LIST_ORG_WORKSPACE_DATATANK`

Tool to list org workspace Datatank with pagination support. Use when you need to retrieve Datatank items for a specific organization and workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data (1-100). If not specified will default to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. |
| `org_handle` | string | Yes | The handle of the org for which we want to list the workspace Datatank. |
| `workspace_handle` | string | Yes | The handle of the workspace. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Organization Workspace Flowpipe Mod Variables

**Slug:** `TURBOT_PIPES_LIST_ORG_WORKSPACE_FLOWPIPE_MOD_VARIABLE`

Tool to list all variables for a flowpipe mod in an organization workspace. Use when you need to retrieve mod variables within a specific workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum items per page (1-100 range). If not specified will default to 25. |
| `mod_alias` | string | Yes | The mod alias or mod ID for which we want the variables to be listed |
| `next_token` | string | No | Pagination cursor for fetching subsequent pages. When list results are truncated, next_token will be returned to fetch the next page of data. |
| `org_handle` | string | Yes | The handle of the organization that owns the workspace |
| `workspace_handle` | string | Yes | The handle of the workspace where the mod was installed |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Org Workspace Mods

**Slug:** `TURBOT_PIPES_LIST_ORG_WORKSPACE_MOD`

Tool to list organization workspace installed mods with pagination support. Use when you need to retrieve installed mods for a specific organization and workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data (1-100). If not specified will default to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. |
| `org_handle` | string | Yes | The handle of an organization that owns the workspace. |
| `workspace_handle` | string | Yes | The handle of the workspace where mods were installed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Organization Workspace Pipelines

**Slug:** `TURBOT_PIPES_LIST_ORG_WORKSPACE_PIPELINE`

Tool to list pipelines for a workspace of an organization. Use when you need to retrieve scheduled tasks for dashboard snapshots or queries within a specific workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of items to fetch per page (1-100). Defaults to 25 if not specified. |
| `where` | string | No | SQL where filter to apply to this request. The filter will be parsed, sanitised and checked against supported columns. |
| `next_token` | string | No | Pagination cursor returned from previous request to fetch the next page of results. |
| `org_handle` | string | Yes | The handle of the organization which contains the workspace. |
| `workspace_handle` | string | Yes | The handle of the workspace for which to list the pipelines. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Org Workspace Processes

**Slug:** `TURBOT_PIPES_LIST_ORG_WORKSPACE_PROCESS`

Tool to list processes associated with an org workspace. Use when you need to retrieve all processes for a specific organization workspace with optional filtering and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum items per page (1-100, default: 25). |
| `where` | string | No | SQL filter clause for request filtering, sanitized against supported columns. |
| `next_token` | string | No | Pagination cursor for fetching subsequent data pages. |
| `org_handle` | string | Yes | The handle of an organization for which you want to list the processes. |
| `workspace_handle` | string | Yes | The handle of the workspace where you want to list the processes. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Organization Workspaces

**Slug:** `TURBOT_PIPES_LIST_ORG_WORKSPACES`

Tool to list workspaces for a specific organization. Use when you need to retrieve all workspaces associated with an organization handle.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of workspaces to fetch per page (1-100). Defaults to 25 if not specified. |
| `next_token` | string | No | Pagination cursor returned from previous request to fetch the next page of results. |
| `org_handle` | string | Yes | The handle of the organization for which to list workspaces. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Tenant Settings

**Slug:** `TURBOT_PIPES_LIST_TENANT_GETSETTINGS`

Tool to retrieve tenant settings. Use when you need to view the current configuration for the tenant, including login methods, session timeouts, and user provisioning settings.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Tenants

**Slug:** `TURBOT_PIPES_LIST_TENANTS`

Tool to list tenants the actor is a member of. Use when you need to retrieve all tenants associated with the authenticated user.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User AI Keys

**Slug:** `TURBOT_PIPES_LIST_USER_AI_KEYS`

Tool to list AI provider API keys configured at the user level. Use when you need to retrieve all AI keys for a specific user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not specified will default to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned. Pass next_token to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user for which to list AI keys. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Audit Logs

**Slug:** `TURBOT_PIPES_LIST_USER_AUDIT_LOGS`

Tool to list audit logs for a specific user. Use when you need to retrieve audit trail information with optional pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. Defaults to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user whose audit logs to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Billing Invoices

**Slug:** `TURBOT_PIPES_LIST_USER_BILLING_INVOICES`

Tool to list user invoices with pagination support. Use when you need to retrieve billing invoice information for a specific user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not specified will default to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user to list invoices for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Billing Payment Methods

**Slug:** `TURBOT_PIPES_LIST_USER_BILLING_PAYMENT_METHOD`

Tool to list user billing payment methods. Use when you need to retrieve payment methods configured for a user's billing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | The handle of the user to list the payment methods for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Billing Subscriptions

**Slug:** `TURBOT_PIPES_LIST_USER_BILLING_SUBSCRIPTION`

Tool to list user billing subscriptions. Use when you need to retrieve subscription information for a specific user. Note: Users typically have one active subscription, but this endpoint may also return historical subscriptions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | The handle of the user to retrieve the subscriptions for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Connections

**Slug:** `TURBOT_PIPES_LIST_USER_CONNECTIONS`

Tool to list connections for a specific user by user handle. Use when you need to retrieve all connections associated with a user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | The handle of the user whose connections to list |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Constraints

**Slug:** `TURBOT_PIPES_LIST_USER_CONSTRAINTS`

Tool to list all applicable constraints for a user. Use when you need to retrieve quota, rate, or setting constraints with optional filtering and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not specified will default to 25. |
| `where` | string | No | The SQL where filter you wish to apply to this request. The filter will be parsed and sanitised and checked against the supported columns for this API. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. |
| `user_handle` | string | Yes | Specify the handle of the user whose constraints you want to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Emails

**Slug:** `TURBOT_PIPES_LIST_USER_EMAILS`

Tool to list emails for a user along with metadata information for each item. Use when you need to retrieve all email addresses associated with a specific user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not specified will default to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. |
| `user_handle` | string | Yes | Specify the handle of the user whose information you want to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Integrations

**Slug:** `TURBOT_PIPES_LIST_USER_INTEGRATION`

Tool to list integrations configured for a user. Use when you need to retrieve all integrations for a specific user with optional pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data (1-100). If not specified will default to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user to which the integration belongs to |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Processes

**Slug:** `TURBOT_PIPES_LIST_USER_PROCESS`

Tool to list processes for a user. Use when you need to retrieve all processes for a specific user with optional pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of processes to return per page (1-100). Defaults to 25. |
| `next_token` | string | No | Token for pagination to retrieve the next page of results. |
| `user_handle` | string | Yes | The handle of the user to list processes for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Usage

**Slug:** `TURBOT_PIPES_LIST_USER_USAGE`

Tool to list all usage metrics for a user. Use when you need to retrieve usage data for billing, monitoring, or analytics purposes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of usage records to return per page (1-100, default 25) |
| `where` | string | No | SQL where filter to apply to the request for filtering usage records |
| `next_token` | string | No | Cursor for pagination to fetch the next page of results (from previous response) |
| `user_handle` | string | Yes | The handle of the user whose usage metrics you want to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Aggregators

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_AGGREGATOR`

Tool to list aggregators for a workspace of a user. Use when you need to retrieve aggregator configurations for a specific user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not specified will default to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user to which the workspace belongs to. |
| `workspace_handle` | string | Yes | The handle of the workspace for which we will be listing aggregators. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Aggregator Connections

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_AGGREGATOR_CONNECTIONS`

Tool to list all connections that are part of an aggregator in a user workspace. Use when you need to retrieve connections within a specific aggregator.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100. Defaults to 25 if not specified. |
| `next_token` | string | No | Pagination cursor for fetching subsequent pages when results are truncated |
| `user_handle` | string | Yes | The handle of the user to which the workspace belongs |
| `workspace_handle` | string | Yes | The handle of the workspace where the aggregator exists |
| `aggregator_handle` | string | Yes | The handle of the aggregator whose connections need to be fetched |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Audit Logs

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_AUDIT_LOGS`

Tool to list audit logs for a specific user workspace. Use when you need to retrieve workspace audit trail information with optional pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. Defaults to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user who owns the workspace |
| `workspace_handle` | string | Yes | The handle of the workspace whose audit logs to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Connections

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_CONNECTION`

Tool to list connections explicitly defined or associated to a workspace. Use when you need to retrieve all connections available in a user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not specified will default to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user |
| `workspace_handle` | string | Yes | The handle of the workspace |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Connection Associations

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_CONNECTION_ASSOCIATION`

Tool to list connections associated with a workspace for a specific user. Use when you need to retrieve all connection associations for a user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not specified will default to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user |
| `workspace_handle` | string | Yes | The handle of the workspace |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Connection Folders

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_CONNECTION_FOLDER`

Tool to list connection folders for a user workspace. Use when you need to retrieve all connection folders associated with a user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not specified will default to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user where the connection folders exist. |
| `workspace_handle` | string | Yes | The handle of the workspace where the connection folders exist. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Connection Tree

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_CONNECTION_TREE`

Tool to list connection tree for a user workspace. Use when you need to retrieve the hierarchical connection structure for a specific user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data (1-100). If not specified will default to 25. |
| `where` | string | No | The SQL where filter you wish to apply to this request. |
| `prefix` | string | No | The prefix to be used when listing items in a connection tree. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user to which the workspace belongs. |
| `workspace_handle` | string | Yes | The handle of the workspace for which we want to retrieve the connection tree. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Conversations

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_CONVERSATIONS`

Tool to list AI conversations in a user workspace with optional filtering and pagination. Use when you need to retrieve conversations from a specific user workspace, optionally filtered by title pattern.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not specified will default to 25 |
| `where` | string | No | Optional filter expression for title. Use to filter conversations by title matching a specific pattern |
| `next_token` | string | No | When list results are truncated, next_token will be returned. Pass next_token to fetch the next page of data |
| `user_handle` | string | Yes | The handle of the user that owns the workspace |
| `workspace_handle` | string | Yes | The handle of the user workspace |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Datatank

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_DATATANK`

Tool to list user workspace Datatank with pagination support. Use when you need to retrieve Datatank items for a specific user and workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data (1-100). If not specified will default to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user for which we want to list the workspace Datatank. |
| `workspace_handle` | string | Yes | The handle of the workspace. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Datatank Partitions

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_DATATANK_PART`

Tool to list user workspace Datatank partitions with pagination support. Use when you need to retrieve partition details for a specific Datatank table in a user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not specified will default to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user for which we want to list the workspace Datatank. |
| `datatank_handle` | string | Yes | The name of the Datatank. |
| `workspace_handle` | string | Yes | The handle of the workspace. |
| `datatank_table_name` | string | Yes | The name of the workspace Datatank table. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Datatank Table

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_DATATANK_TABLE`

Tool to list user workspace Datatank tables with pagination support. Use when you need to retrieve datatank tables for a specific user, workspace, and datatank.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of items to return (1-100). If not specified will default to 25. |
| `next_token` | string | No | Pagination token for fetching the next page of results. |
| `user_handle` | string | Yes | The handle of the user. |
| `datatank_handle` | string | Yes | The handle of the datatank. |
| `workspace_handle` | string | Yes | The handle of the workspace. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Database Logs

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_DB_LOGS`

Tool to list database query logs for a specific user workspace. Use when you need to retrieve workspace database query history with optional pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. Defaults to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user who owns the workspace |
| `workspace_handle` | string | Yes | The handle of the workspace whose database logs to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Flowpipe Inputs

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_FLOWPIPE_INPUT`

Tool to list Flowpipe inputs for a user workspace. Use when you need to retrieve all Flowpipe inputs for a specific workspace with optional pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data (1-100). If not specified will default to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user to which the workspace belongs. |
| `workspace_handle` | string | Yes | The handle of the workspace to which the Flowpipe inputs belong. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Flowpipe Mod Variables

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_FLOWPIPE_MOD_VARIABLE`

Tool to list all variables for a flowpipe mod in a user workspace. Use when you need to retrieve mod variables within a specific workspace owned by a user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum items per page (1-100 range). If not specified will default to 25. |
| `mod_alias` | string | Yes | The mod alias or mod ID for which we want the variables to be listed |
| `next_token` | string | No | Pagination cursor for fetching subsequent pages. When list results are truncated, next_token will be returned to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user that owns the workspace |
| `workspace_handle` | string | Yes | The handle of the workspace where the mod was installed |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Flowpipe Pipelines

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_FLOWPIPE_PIPELINE`

Tool to list Flowpipe pipelines for a user workspace. Use when you need to retrieve pipelines within a specific workspace belonging to a user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not specified will default to 25. |
| `where` | string | No | The SQL where filter you wish to apply to this request. The filter will be parsed and sanitised and checked against the supported columns for this API. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user which contains the workspace. |
| `workspace_handle` | string | Yes | The handle of the workspace for which we want to list the pipelines. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Pipeline Triggers

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_FLOWPIPE_PIPELINE_TRIGGER`

Tool to list Flowpipe triggers associated with a specific pipeline in a user workspace. Use when you need to retrieve all triggers configured for a particular pipeline.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not specified will default to 25. |
| `where` | string | No | The SQL where filter you wish to apply to this request. The filter will be parsed and sanitised and checked against the supported columns for this API. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. |
| `pipeline_id` | string | Yes | The id of the pipeline whose triggers need to be fetched. |
| `user_handle` | string | Yes | The handle of the user which contains the workspace. |
| `workspace_handle` | string | Yes | The handle of the workspace where the pipeline exists. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Flowpipe Triggers

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_FLOWPIPE_TRIGGER`

Tool to list Flowpipe triggers for a user workspace. Use when you need to retrieve all triggers configured in a specific user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not specified will default to 25. |
| `where` | string | No | The SQL where filter you wish to apply to this request. The filter will be parsed and sanitised and checked against the supported columns for this API. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user which contains the workspace. |
| `workspace_handle` | string | Yes | The handle of the workspace for which we want to list the triggers. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Integrations

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_INTEGRATION`

Tool to list integrations available for a user workspace. Use when you need to retrieve all integrations configured for a specific user workspace. If run on a custom tenant, this will return integrations configured both on tenant and user level.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data (1-100). If not specified will default to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user to which the workspace belongs to. |
| `workspace_handle` | string | Yes | The handle of the workspace for whom you want to list available integrations. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Mods

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_MOD`

Tool to list user workspace installed mods with pagination support. Use when you need to retrieve installed mods for a specific user and workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data (1-100). If not specified will default to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user who owns the workspace. |
| `workspace_handle` | string | Yes | The handle of the workspace where mods were installed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Mod Variables

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_MOD_VARIABLE`

Tool to list all variables applicable for a mod in a workspace specific to a user. Use when you need to retrieve mod variables within a specific user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not specified will default to 25 |
| `mod_alias` | string | Yes | The alias of the mod |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data |
| `user_handle` | string | Yes | The handle of the user for which we want to list the workspace mod variables |
| `workspace_handle` | string | Yes | The handle of the workspace |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Notifiers

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_NOTIFIER`

Tool to list all notifiers for a user workspace. Use when you need to view notification endpoints configured for a specific user's workspace with optional pagination and filtering.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The maximum number of items to return |
| `where` | string | No | The filter to apply to the list |
| `next_token` | string | No | The token to retrieve the next page of results |
| `user_handle` | string | Yes | The handle of the user for which the notifiers are to be listed |
| `workspace_handle` | string | Yes | The handle of the workspace for which the notifiers are to be listed |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Pipelines

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_PIPELINE`

Tool to list pipelines for a workspace of a user. Use when you need to retrieve scheduled tasks for dashboard snapshots or queries within a specific user workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of items to fetch per page (1-100). Defaults to 25 if not specified. |
| `where` | string | No | SQL where filter to apply to this request. The filter will be parsed, sanitised and checked against supported columns. |
| `next_token` | string | No | Pagination cursor returned from previous request to fetch the next page of results. |
| `user_handle` | string | Yes | The handle of the user who owns the workspace. |
| `workspace_handle` | string | Yes | The handle of the workspace for which to list the pipelines. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Processes

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_PROCESS`

Tool to list processes associated with a user workspace. Use when you need to retrieve all processes for a specific user workspace with optional filtering and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not specified will default to 25. |
| `where` | string | No | The SQL where filter you wish to apply to this request. The filter will be parsed and sanitised and checked against the supported columns for this API. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user for which you want to start listing processes. |
| `workspace_handle` | string | Yes | The handle of the workspace where you want to list the processes. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspaces

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACES`

Tool to list workspaces for a specific user. Use when you need to retrieve all workspaces associated with a user handle.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of workspaces to fetch per page (1-100). Defaults to 25 if not specified. |
| `next_token` | string | No | Pagination cursor returned from previous request to fetch the next page of results. |
| `user_handle` | string | Yes | The handle of the user for which to list workspaces. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Schemas

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_SCHEMA`

Tool to list schemas for a user workspace. Use when you need to retrieve schemas including aggregators, datatanks, and identity-level connections for a specific user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not specified will default to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user that the workspace belongs to |
| `workspace_handle` | string | Yes | The handle of the workspace to get the schemas for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Schema Tables

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_SCHEMA_TABLE`

Tool to list tables for a user workspace schema with pagination support. Use when you need to retrieve tables for a specific user, workspace, and schema.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data (1-100). If not specified will default to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. |
| `schema_name` | string | Yes | The name of the schema for which to list tables. |
| `user_handle` | string | Yes | The handle of the user. |
| `workspace_handle` | string | Yes | The handle of the workspace. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Snapshots

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_SNAPSHOT`

Tool to list workspace snapshots for a user. Use when you need to retrieve snapshots from a specific user workspace with optional pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not provided, defaults to 25. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user that the workspace snapshots belong to |
| `workspace_handle` | string | Yes | The handle of the user workspace whose snapshots to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Workspace Usage

**Slug:** `TURBOT_PIPES_LIST_USER_WORKSPACE_USAGE`

Tool to list the usage associated with a user workspace. Use when you need to retrieve usage metrics for a specific user's workspace with optional filtering and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The max number of items to fetch per page of data (1-100). If not specified will default to 25. |
| `where` | string | No | The SQL where filter you wish to apply to this request. The filter will be parsed and sanitised and checked against the supported columns for this API. |
| `next_token` | string | No | When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. |
| `user_handle` | string | Yes | The handle of the user for which you want to list workspace usage. |
| `workspace_handle` | string | Yes | The handle of the workspace where you want to list the usage. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Post User Workspace Notifier Command

**Slug:** `TURBOT_PIPES_POST_USER_WORKSPACE_NOTIFIER_COMMAND`

Tool to post a command for a notifier in a user's workspace. Use when you need to execute commands on workspace notifiers, such as setting a notifier as the default.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `command` | string ("set_default") | Yes | Command to execute on the workspace notifier. Valid command: set_default |
| `user_handle` | string | Yes | The handle of the user for which the notifier command is being executed |
| `notifier_name` | string | Yes | The name of the notifier where the command is directed |
| `workspace_handle` | string | Yes | The handle of the workspace containing the notifier |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Post User Workspace Query

**Slug:** `TURBOT_PIPES_POST_USER_WORKSPACE_QUERY`

Tool to perform a SQL query in a user workspace. Use when you need to execute queries against Turbot Pipes user workspaces. Results are limited to 5000 rows or 30 seconds of execution time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sql` | string | Yes | SQL query to execute against the workspace. Results are limited to 5000 rows or 30 seconds of query execution |
| `user_handle` | string | Yes | The handle of the user that owns the workspace |
| `workspace_handle` | string | Yes | The handle of the workspace where the query will be executed |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Run Organization Workspace Command

**Slug:** `TURBOT_PIPES_RUN_ORG_WORKSPACE_COMMAND`

Tool to run a command in an organization workspace. Use when you need to execute workspace operations like rebooting a workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `command` | string ("reboot") | Yes | The command to run on the workspace. Valid commands are: reboot. |
| `org_handle` | string | Yes | The handle of the org where we want to run the workspace command. |
| `workspace_handle` | string | Yes | The handle of the workspace where command will be executed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Run User Workspace Command

**Slug:** `TURBOT_PIPES_RUN_USER_WORKSPACE_COMMAND`

Tool to run a command in a user workspace. Use when you need to execute workspace operations like rebooting a user's workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `command` | string ("reboot") | Yes | The command to run on the workspace. Valid commands are: reboot. |
| `user_handle` | string | Yes | The handle of the user where we want to run the workspace command. |
| `workspace_handle` | string | Yes | The handle of the workspace where command will be executed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Run User Workspace Flowpipe Pipeline Command

**Slug:** `TURBOT_PIPES_RUN_USER_WORKSPACE_FLOWPIPE_PIPELINE_COMMAND`

Tool to run a command on a Flowpipe pipeline in a user workspace. Use when you need to execute a pipeline command such as 'run' to start pipeline execution.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `args` | object | No | Arguments to pass to the pipeline command. |
| `command` | string ("run") | Yes | The command to run on the pipeline. Currently only 'run' is supported. |
| `user_handle` | string | Yes | The handle of the user which contains the workspace. |
| `pipeline_name` | string | Yes | Identifier of the Flowpipe pipeline on which the command will be run. |
| `workspace_handle` | string | Yes | The handle of the workspace where the Flowpipe pipeline exists. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Run User Workspace Flowpipe Trigger Command

**Slug:** `TURBOT_PIPES_RUN_USER_WORKSPACE_FLOWPIPE_TRIGGER_COMMAND`

Tool to run a command on a trigger in a workspace belonging to a user. Use when you need to execute or reset a Flowpipe trigger.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `args` | object | No | Optional arguments to pass to the trigger when executing the command. |
| `command` | string ("run" | "reset") | Yes | Command to execute on the trigger. Valid commands are: run (execute the trigger), reset (reset the trigger state). |
| `user_handle` | string | Yes | The handle of the user which contains the workspace. |
| `trigger_name` | string | Yes | The name of the flowpipe trigger to execute the command on. |
| `workspace_handle` | string | Yes | The handle of the workspace where the trigger exists. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Run User Workspace Query

**Slug:** `TURBOT_PIPES_RUN_USER_WORKSPACE_QUERY`

Tool to perform a SQL query in a user workspace using POST method. Use when you need to execute queries against Turbot Pipes user workspaces. Results are limited to 5000 rows or 30 seconds of execution time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sql` | string | Yes | SQL SELECT statement to execute against the workspace. Results are limited to 5000 rows or 30 seconds of query execution |
| `extensions` | string ("json" | "csv" | "md") | Yes | Output format extension that determines response content type (json, csv, or md) |
| `user_handle` | string | Yes | The handle of the user that owns the workspace |
| `workspace_handle` | string | Yes | The handle of the workspace where the query will be executed |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Chat Message to User Workspace AI

**Slug:** `TURBOT_PIPES_SEND_USER_WORKSPACE_CHAT_MESSAGE`

Tool to send a chat message to the AI agent in a user workspace. Creates a new conversation if conversation_id is not provided, or continues an existing conversation if provided.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `model` | string | Yes | The AI model to use (e.g., 'gpt-4', 'claude-sonnet-4-5'). |
| `message` | string | Yes | The chat message to send to the AI agent. |
| `provider` | string | Yes | The AI provider to use (e.g., 'openai', 'anthropic'). |
| `user_handle` | string | Yes | The handle of the user that owns the workspace. |
| `conversation_id` | string | No | The ID of an existing conversation to continue. If not provided, a new conversation will be created. Must match pattern ^conv[0-9a-v]{20}$ |
| `workspace_handle` | string | Yes | The handle of the user workspace. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Test User AI Key

**Slug:** `TURBOT_PIPES_TEST_USER_AI_KEY`

Tool to test whether an AI provider API key is valid at the user level. Use when you need to verify if a saved or provided API key works correctly with the specified provider.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `api_key` | string | No | The API key to validate against the specified provider. If not provided, tests the existing saved key for the provider |
| `provider` | string ("openai" | "anthropic") | Yes | AI provider to test the key against (openai or anthropic) |
| `user_handle` | string | Yes | Handle of the user for which to test the AI key |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Test User Connection

**Slug:** `TURBOT_PIPES_TEST_USER_CONNECTION`

Tool to test a user connection for basic connectivity. Use when you need to verify if a connection's configuration is valid and the credentials work correctly with the specified plugin.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `config` | object | No | Optional configuration object for the connection test. The structure depends on the plugin type |
| `plugin` | string | Yes | The plugin type for the connection (e.g., 'aws', 'gcp', 'azure') |
| `user_handle` | string | Yes | The handle of the user where the connection exists |
| `connection_handle` | string | Yes | The handle of the connection to be tested |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Test User Integration

**Slug:** `TURBOT_PIPES_TEST_USER_INTEGRATION`

Tool to test the config for a user integration to check for basic connectivity before you create it. Use when you need to validate integration credentials and configuration by providing the user handle, integration handle (or _ for new integrations), integration type, and config.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string | Yes | The type of the integration being tested (e.g., slack, github, email). |
| `config` | object | Yes | Configuration properties for the integration. The structure varies based on the integration type. |
| `user_handle` | string | Yes | The handle of the user to which the integration belongs to. |
| `integration_handle` | string | Yes | The handle of the integration to be tested. For integrations that are not yet created, use underscore `_` as the handle, else pass the handle of the existing integration. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Test User Workspace Connection

**Slug:** `TURBOT_PIPES_TEST_USER_WORKSPACE_CONNECTION`

Tool to test the config for a connection configured on a user workspace to check for basic connectivity. Use when you need to verify that a connection is properly configured before creating or using it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `config` | object | No | Optional configuration data for the connection test |
| `plugin` | string | Yes | The plugin name for the connection to be tested |
| `user_handle` | string | Yes | The handle of the user where the connection exists / intends to be created |
| `workspace_handle` | string | Yes | The handle of the workspace where the connection exists |
| `connection_handle` | string | Yes | The handle of the connection to be tested. For connections that are not yet created, use underscore `_` as the handle, else pass the handle of the existing connection |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Uninstall Flowpipe Mod

**Slug:** `TURBOT_PIPES_UNINSTALL_FLOWPIPE_MOD`

Tool to uninstall a flowpipe mod from a user's workspace. Use when you need to remove a flowpipe mod from a specific workspace after confirming the user handle, workspace handle, and mod alias.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mod_alias` | string | Yes | Unique alias or identifier of the flowpipe mod to uninstall |
| `user_handle` | string | Yes | Unique handle or identifier for the user who owns the workspace |
| `workspace_handle` | string | Yes | Unique handle or identifier for the workspace from which to uninstall the mod |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Uninstall Org Workspace Flowpipe Mod

**Slug:** `TURBOT_PIPES_UNINSTALL_ORG_WORKSPACE_FLOWPIPE_MOD`

Tool to uninstall a flowpipe mod from an organization workspace. Use when you need to remove a flowpipe mod from a specific workspace after confirming org handle, workspace handle, and mod alias.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mod_alias` | string | Yes | The mod alias or mod ID to delete |
| `org_handle` | string | Yes | The handle of an organization that owns the workspace |
| `workspace_handle` | string | Yes | The handle of the workspace where the mod was installed |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update User Workspace Conversation

**Slug:** `TURBOT_PIPES_UPDATE_CONVERSATION_USER`

Tool to update a user workspace conversation (e.g., title). Use when you need to modify properties of an AI conversation in a user workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | Yes | The new title for the conversation |
| `user_handle` | string | Yes | The handle of the user that owns the workspace |
| `conversation_id` | string | Yes | The unique identifier of the conversation to update |
| `workspace_handle` | string | Yes | The handle of the user workspace |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Org Billing Subscription

**Slug:** `TURBOT_PIPES_UPDATE_ORG_BILLING_SUBSCRIPTION`

Tool to update an organization billing subscription. Use to stop cancellation at the next billing period by passing 'stopcancel' action or to upgrade the subscription. Useful when managing org subscription lifecycle.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `action` | string ("stopcancel" | "upgrade") | Yes | Action to perform on the subscription. Use 'stopcancel' to stop cancellation at the next billing period, or 'upgrade' to upgrade the subscription |
| `org_handle` | string | Yes | The handle of the organization |
| `subscription_id` | string | Yes | The org subscription id |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Org Connection

**Slug:** `TURBOT_PIPES_UPDATE_ORG_CONNECTION`

Tool to update the details of a connection belonging to an organization. Use when you need to modify connection configuration, change config/credential sources, rename the connection handle, or reassign the connection to a different parent entity.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `config` | object | No | The plugin or connection configuration |
| `handle` | string | No | The handle name for the connection. Must match pattern: lowercase letter, followed by alphanumeric or underscore (not ending with underscore), max 39 chars |
| `parent_id` | string | No | The ID of the entity where the connection is stored. Can be either tenant, identity, workspace or connection-folder |
| `org_handle` | string | Yes | The handle of the organization where the connection exists |
| `config_source` | string ("self" | "inherited") | No | Source of the configuration for the connection. |
| `connection_handle` | string | Yes | The handle of the connection which needs to be updated |
| `credential_source` | string ("self" | "inherited") | No | Source of the credential for the connection. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Org Connection Folder

**Slug:** `TURBOT_PIPES_UPDATE_ORG_CONNECTION_FOLDER`

Tool to update the details of an org connection folder. Use when you need to modify the title or parent location of a connection folder.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | The new title for the connection folder. Must match pattern: ^[a-z](?:[a-z0-9]\|_(?=[a-z0-9])){0,38}$ (lowercase letters, numbers, underscores, 1-39 chars). |
| `folder_id` | string | Yes | The unique identifier of the connection folder to update. |
| `parent_id` | string | No | The new parent ID for the connection folder. Use to move the folder to a different parent location. |
| `org_handle` | string | Yes | The handle of the organization that owns the connection folder. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Organization Member Role

**Slug:** `TURBOT_PIPES_UPDATE_ORG_MEMBER`

Tool to update the role of an organization member. Use when you need to change a member's role (e.g., promote to owner or demote to member) within an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `role` | string | Yes | The role to assign to the org member. Common values include 'owner', 'member', 'viewer' |
| `org_handle` | string | Yes | The handle of the organization |
| `user_handle` | string | Yes | The handle of the user/member to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Organization Service Account

**Slug:** `TURBOT_PIPES_UPDATE_ORG_SERVICE_ACCOUNT`

Tool to update an existing service account at the organization level. Use when you need to modify the title, description, or token_min_issued_at for a service account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | The title of the service account user |
| `org_handle` | string | Yes | The handle of the organization containing the service account |
| `description` | string | No | The description of the service account user |
| `token_min_issued_at` | string | No | The time which user and temporary auth tokens must be issued after |
| `service_account_identifier` | string | Yes | The unique identifier of the service account to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Organization Service Account Token

**Slug:** `TURBOT_PIPES_UPDATE_ORG_SERVICE_ACCOUNT_TOKEN`

Tool to update an existing token for an organization-level service account. Use when you need to modify token properties such as status, title, or description.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | The title or name of the token |
| `status` | string | Yes | The status of the token (e.g., 'active', 'inactive') |
| `token_id` | string | Yes | The identifier of the token to update |
| `org_handle` | string | Yes | The handle of the organization |
| `description` | string | No | A description of the token |
| `service_account_identifier` | string | Yes | The ID of the service account |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update User

**Slug:** `TURBOT_PIPES_UPDATE_USER`

Tool to update user information including handle name, display name, or URL. Use when you need to modify user attributes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | No | The URL to set for the user. |
| `handle` | string | No | The new handle name for the user. Must match pattern: ^[a-z0-9]{1,2}(?:[a-z0-9]{1,2}\|-[a-z0-9]){0,18}[a-z0-9]?$ |
| `user_handle` | string | Yes | Specify the handle of the user which needs to be updated. |
| `display_name` | string | No | The display name to set for the user. |
| `token_min_issued_at` | string | No | The time which user and temporary auth tokens must be issued after. |
| `usage_compute_action` | string ("warn" | "cap_and_warn") | No | Enum for usage action types. |
| `usage_storage_action` | string ("warn" | "cap_and_warn") | No | Enum for usage action types. |
| `usage_compute_threshold` | integer | No | Threshold for compute usage. |
| `usage_storage_threshold` | integer | No | Threshold for storage usage. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update User AI Key

**Slug:** `TURBOT_PIPES_UPDATE_USER_AI_KEY`

Tool to update an existing AI provider API key at the user level. Use when you need to update an API key for a specific AI provider (OpenAI or Anthropic) for a user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `api_key` | string | Yes | The new API key for the AI provider |
| `provider` | string ("openai" | "anthropic") | Yes | AI provider for which to update the key (openai or anthropic) |
| `user_handle` | string | Yes | Handle of the user that owns the AI key |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update User Connection

**Slug:** `TURBOT_PIPES_UPDATE_USER_CONNECTION`

Tool to update the details of a connection belonging to a user. Use when you need to modify configuration, handle, parent_id, config_source, or credential_source of a user's connection. Requires user_handle and connection_handle to identify the target connection.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string ("available") | No | Mode of the request. |
| `config` | object | No | The plugin or connection configuration. This is a flexible object that can contain various configuration parameters depending on the connection type |
| `handle` | string | No | The handle name to update for the connection. Must start with a lowercase letter, followed by up to 38 lowercase letters, digits, or underscores. Maximum length is 39 characters |
| `parent_id` | string | No | The id of the entity where the connection is stored. Can be either tenant, identity, workspace or connection-folder |
| `user_handle` | string | Yes | The handle of the user where the connection exists |
| `config_source` | string ("self" | "inherited") | No | Source of the configuration that the connection will use. |
| `connection_handle` | string | Yes | The handle of the connection which needs to be updated |
| `credential_source` | string ("self" | "inherited") | No | Source of the credential that the connection will use. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update User Integration

**Slug:** `TURBOT_PIPES_UPDATE_USER_INTEGRATION`

Tool to update details of an integration configured for a user. Use when you need to modify an existing user integration's state, handle, or configuration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `state` | string ("enabled" | "disabled") | No | Integration state enum. |
| `config` | object | No | The configuration for the integration. |
| `handle` | string | No | The handle for the integration. |
| `user_handle` | string | Yes | The handle of the user on which the integration is configured. |
| `integration_handle` | string | Yes | The handle of the integration whose details need to be updated. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update User Preferences

**Slug:** `TURBOT_PIPES_UPDATE_USER_PREFERENCES`

Tool to update user preferences for email communications. Use when you need to change a user's communication preferences such as opting in or out of product updates, community updates, or tips and tricks emails.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | Specify the handle of the user whose preferences need to be updated. |
| `communication_product_updates` | string ("enabled" | "disabled") | No | Communication preference setting for email notifications. |
| `communication_tips_and_tricks` | string ("enabled" | "disabled") | No | Communication preference setting for email notifications. |
| `communication_community_updates` | string ("enabled" | "disabled") | No | Communication preference setting for email notifications. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update User Token

**Slug:** `TURBOT_PIPES_UPDATE_USER_TOKEN`

Tool to update a user token's status between active and inactive. Use when you need to enable or disable a token without deleting it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | Optional title to update for the token |
| `status` | string ("active" | "inactive") | Yes | New status for the token - 'active' to activate or 'inactive' to deactivate the token |
| `token_id` | string | Yes | The identifier of the token to update |
| `description` | string | No | Optional description to update for the token |
| `user_handle` | string | Yes | The handle of the user where the token exists |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update User Workspace

**Slug:** `TURBOT_PIPES_UPDATE_USER_WORKSPACE`

Tool to update the workspace for a user. Use when you need to modify workspace settings such as desired state, instance type, database volume size, or search path prefix.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `handle` | string | No | The new handle for the workspace. Must match pattern: ^[a-z0-9]{1,23}$ |
| `user_handle` | string | Yes | The handle of the user where the workspace exist. |
| `desired_state` | string ("enabled" | "disabled") | No | Workspace desired state enum. |
| `instance_type` | string ("db1.shared" | "db1.small" | "db1.medium") | No | Workspace instance type enum. |
| `workspace_handle` | string | Yes | The handle of the workspace which needs to be updated. |
| `search_path_prefix` | array | No | Optionally update the search path prefix for the Steampipe DB. |
| `db_volume_size_bytes` | integer | No | The size of the database volume in bytes. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Notifiers

**Slug:** `TURBOT_PIPES_USER_NOTIFIERS_LIST`

Tool to list all notifiers for a user. Use when you need to view a user's configured notification endpoints.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_handle` | string | Yes | Handle of the user whose notifiers to list |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete User Token

**Slug:** `TURBOT_PIPES_USER_TOKENS_DELETE`

Tool to delete a specific user token. Use when you need to revoke a user's token after confirming handle and token ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `token_id` | string | Yes | Unique identifier of the token to be deleted |
| `user_handle` | string | Yes | Unique handle or identifier for the user whose token will be deleted |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Token

**Slug:** `TURBOT_PIPES_USER_TOKENS_GET`

Tool to retrieve details of a specific user token. Use when you need to inspect token metadata (e.g., creation time and scopes) after confirming the user handle and token ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `token_id` | string | Yes | Unique identifier of the token to retrieve |
| `user_handle` | string | Yes | Handle of the user in the system |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |