> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Griptape

The Griptape connector lets your AI agent act in each user's Griptape account. Each user connects their own Griptape access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 59 tools.

**Authentication:** Bearer Token
**Categories:** AI, Developer Tools
**Tools:** 59: 35 read, 15 write, 9 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=GRIPTAPE)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Griptape connection

   In **AgentKit > Connections**, create a Griptape connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'griptape'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Griptape:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'griptape_buckets_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "griptape"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Griptape:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="griptape_buckets_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Griptape credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'griptape_bucket_asset_get',
  toolInput: {
    bucket_id: '<bucket_id>',
    name: '<name>',
  },
  connector: 'griptape',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="griptape_bucket_asset_get",
    tool_input={
        "bucket_id": "<bucket_id>",
        "name": "<name>",
    },
    connection_name="griptape",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `griptape_bucket_asset_get`

Get Bucket Asset · Read-only

Get the metadata of one file in a Griptape Cloud bucket.
Returns the asset's name, size, content type and timestamps.
Use this to check a file exists.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bucket_id` (`string`, required): ID of the bucket, from griptape_buckets_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.
- `name` (`string`, required): Asset name (path in the bucket). Example: faq.pdf.

Example input: `{"bucket_id":"<bucket_id>","name":"<name>"}`

### `griptape_bucket_assets_list`

List Bucket Assets · Read-only

List the files (assets) in a Griptape Cloud bucket, optionally by name prefix or suffix.
Returns assets with name, size, content type and timestamps.
Use this to browse a bucket.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bucket_id` (`string`, required): ID of the bucket, from griptape_buckets_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Results per page. Example: 20.
- `postfix` (`string`, optional): Only assets whose name ends with this text. Example: .pdf.
- `prefix` (`string`, optional): Only assets whose name starts with this text. Example: faq/.

Example input: `{"bucket_id":"<bucket_id>"}`

### `griptape_bucket_get`

Get Bucket · Read-only

Get one Griptape Cloud bucket.
Returns the bucket's name and timestamps.
Use this for a bucket's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bucket_id` (`string`, required): ID of the bucket, from griptape_buckets_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"bucket_id":"<bucket_id>"}`

### `griptape_buckets_list`

List Buckets · Read-only

List Griptape Cloud data buckets (file storage).
Returns buckets with ID, name and timestamps.
Use this to find a bucket.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Results per page. Example: 20.

Example input: `{}`

### `griptape_credit_balance_get`

Get Credit Balance · Read-only

Get the Griptape Cloud credit balance of your organization.
Returns the remaining credits.
Use this before running large jobs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `griptape_credit_transactions_list`

List Credit Transactions · Read-only

List Griptape Cloud credit transactions (purchases and usage).
Returns transactions with amount, type and timestamp.
Use this to audit credit spend.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Results per page. Example: 20.

Example input: `{}`

### `griptape_deployment_get`

Get Deployment · Read-only

Get one Griptape Cloud deployment.
Returns the deployment's status, code source, logs location and timestamps.
Use this to follow a build.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `deployment_id` (`string`, required): ID of the deployment, from griptape_structure_deployments_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"deployment_id":"<deployment_id>"}`

### `griptape_event_get`

Get Event · Read-only

Get one event emitted by a Griptape Cloud structure run.
Returns the event's type, payload and timestamp.
Use this for one event's full payload.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `event_id` (`string`, required): ID of the event, from griptape_structure_run_events_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"event_id":"<event_id>"}`

### `griptape_integration_get`

Get Integration · Read-only

Get one Griptape Cloud integration.
Returns the integration's name, type, configuration and linked structures.
Use this for an integration's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `integration_id` (`string`, required): ID of the integration, from griptape_integrations_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"integration_id":"<integration_id>"}`

### `griptape_integrations_list`

List Integrations · Read-only

List the Griptape Cloud integrations (such as Slack or webhook triggers) that connect structures to other services.
Returns integrations with ID, name, type and the structures they trigger.
Use this to see how structures are triggered.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Results per page. Example: 20.

Example input: `{}`

### `griptape_message_get`

Get Message · Read-only

Get one message of a Griptape Cloud thread.
Returns the message's input, output and metadata.
Use this for one turn's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `message_id` (`string`, required): ID of the message, from griptape_thread_messages_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"message_id":"<message_id>"}`

### `griptape_model_get`

Get Model · Read-only

Get one Griptape Cloud model configuration.
Returns the model's name, provider, type and settings.
Use this for a model's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `model_config_id` (`string`, required): ID of the model configuration, from griptape_models_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"model_config_id":"<model_config_id>"}`

### `griptape_models_list`

List Models · Read-only

List the model configurations available in Griptape Cloud, optionally by type or only defaults.
Returns models with ID, name, provider and type.
Use this to see which LLMs and embedding models can be used.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `default` (`boolean`, optional): True lists only the default models. Example: true.
- `model_type` (`string`, optional): Model type filter, such as prompt or embedding. Example: prompt.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Results per page. Example: 20.

Example input: `{}`

### `griptape_organizations_list`

List Organizations · Read-only

List the Griptape Cloud organizations the API key's user belongs to.
Returns organizations with ID, name and entitlement.
Use this to check which organization the key works in.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `griptape_rule_get`

Get Rule · Read-only

Get one Griptape Cloud rule.
Returns the rule's name, text and metadata.
Use this for a rule's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `rule_id` (`string`, required): ID of the rule, from griptape_rules_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"rule_id":"<rule_id>"}`

### `griptape_rules_list`

List Rules · Read-only

List Griptape Cloud rules, optionally only those in one ruleset.
Returns rules with ID, name, rule text and metadata.
Use this to find rules.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Results per page. Example: 20.
- `ruleset_id` (`string`, optional): Only rules in this ruleset. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{}`

### `griptape_ruleset_get`

Get Ruleset · Read-only

Get one Griptape Cloud ruleset.
Returns the ruleset's name, alias, description and rule IDs.
Use this for a ruleset's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ruleset_id` (`string`, required): ID of the ruleset, from griptape_rulesets_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"ruleset_id":"<ruleset_id>"}`

### `griptape_rulesets_list`

List Rulesets · Read-only

List Griptape Cloud rulesets (groups of rules that steer agent behavior), optionally by alias.
Returns rulesets with ID, name, alias, description and rule IDs.
Use this to find a ruleset.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `alias` (`string`, optional): Only the ruleset with this alias. Example: support-tone.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Results per page. Example: 20.

Example input: `{}`

### `griptape_secrets_list`

List Secrets · Read-only

List the Griptape Cloud secrets (names only; values are never returned).
Returns secrets with ID, name and timestamps.
Use this to find a secret ID for a structure's environment variables.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Results per page. Example: 20.

Example input: `{}`

### `griptape_structure_deployments_list`

List Structure Deployments · Read-only

List the deployments (builds) of a Griptape Cloud structure.
Returns deployments with ID, status, code version and timestamps.
Use this to check whether the latest code built successfully.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `structure_id` (`string`, required): ID of the structure, from griptape_structures_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Results per page. Example: 20.

Example input: `{"structure_id":"<structure_id>"}`

### `griptape_structure_get`

Get Structure · Read-only

Get one Griptape Cloud structure.
Returns the structure's name, description, code source, environment variable names and webhook setting.
Use this for a structure's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `structure_id` (`string`, required): ID of the structure, from griptape_structures_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"structure_id":"<structure_id>"}`

### `griptape_structure_run_events_list`

List Structure Run Events · Read-only

List the events a Griptape Cloud structure run emitted, such as task starts, tool calls and the final output.
Returns events with type, payload and timestamp.
Use this to see what an agent did step by step.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `structure_run_id` (`string`, required): ID of the structure run, from griptape_structure_runs_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.
- `limit` (`string`, optional): Maximum number of events to return. Example: 50.
- `offset` (`string`, optional): Number of events to skip. Example: 0.

Example input: `{"structure_run_id":"<structure_run_id>"}`

### `griptape_structure_run_get`

Get Structure Run · Read-only

Get one Griptape Cloud structure run.
Returns the run's status, arguments, output, errors and timestamps.
Use this to poll a run until it reaches SUCCEEDED or FAILED.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `structure_run_id` (`string`, required): ID of the structure run, from griptape_structure_runs_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"structure_run_id":"<structure_run_id>"}`

### `griptape_structure_run_logs_list`

List Structure Run Logs · Read-only

List the logs of a Griptape Cloud structure run.
Returns log lines with timestamps.
Use this to debug a failed run.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `structure_run_id` (`string`, required): ID of the structure run, from griptape_structure_runs_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"structure_run_id":"<structure_run_id>"}`

### `griptape_structure_runs_list`

List Structure Runs · Read-only

List the runs of a Griptape Cloud structure, optionally by status.
Returns runs with ID, status, arguments, output and timestamps.
Use this to find recent runs. Use griptape_structure_run_get for one run.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `structure_id` (`string`, required): ID of the structure, from griptape_structures_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Results per page. Example: 20.
- `status` (`string`, optional): Comma-separated run statuses to filter by, such as SUCCEEDED,FAILED (also QUEUED, RUNNING, CANCELLED, ERROR). Example: SUCCEEDED,FAILED.

Example input: `{"structure_id":"<structure_id>"}`

### `griptape_structures_list`

List Structures · Read-only

List the Griptape Cloud structures (deployed agents, pipelines and workflows) in your organization.
Returns structures with ID, name, description, code source and latest deployment.
Use this to find a structure to run. Use griptape_structure_run_create to run one.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Results per page. Example: 20.

Example input: `{}`

### `griptape_thread_get`

Get Thread · Read-only

Get one Griptape Cloud thread.
Returns the thread's name, alias, metadata and message count.
Use this for a thread's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `thread_id` (`string`, required): ID of the thread, from griptape_threads_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"thread_id":"<thread_id>"}`

### `griptape_thread_messages_list`

List Thread Messages · Read-only

List the messages (input and output turns) in a Griptape Cloud thread.
Returns messages with ID, input, output, metadata and timestamps.
Use this to read a conversation.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `thread_id` (`string`, required): ID of the thread, from griptape_threads_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Results per page. Example: 20.

Example input: `{"thread_id":"<thread_id>"}`

### `griptape_threads_list`

List Threads · Read-only

List Griptape Cloud conversation threads (conversation memory), optionally by alias or name prefix.
Returns threads with ID, name, alias, message count and metadata.
Use this to find a thread. Use griptape_thread_messages_list for its messages.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `alias` (`string`, optional): Only the thread with this alias. Example: customer-123.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Results per page. Example: 20.
- `starts_with` (`string`, optional): Only threads whose name starts with this text. Example: Support.

Example input: `{}`

### `griptape_tool_get`

Get Tool · Read-only

Get one Griptape Cloud tool.
Returns the tool's name, description, code source and settings.
Use this for a tool's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `tool_id` (`string`, required): ID of the tool, from griptape_tools_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"tool_id":"<tool_id>"}`

### `griptape_tool_run_get`

Get Tool Run · Read-only

Get one Griptape Cloud tool run.
Returns the run's activity, status, input, output and timestamps.
Use this for one call's result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `tool_run_id` (`string`, required): ID of the tool run, from griptape_tool_runs_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"tool_run_id":"<tool_run_id>"}`

### `griptape_tool_run_logs_list`

List Tool Run Logs · Read-only

List the logs of a Griptape Cloud tool run.
Returns log lines with timestamps.
Use this to debug a failed tool call.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `tool_run_id` (`string`, required): ID of the tool run, from griptape_tool_runs_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"tool_run_id":"<tool_run_id>"}`

### `griptape_tool_runs_list`

List Tool Runs · Read-only

List the runs of a Griptape Cloud tool.
Returns runs with ID, activity, status, input, output and timestamps.
Use this to see how a tool has been called.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `tool_id` (`string`, required): ID of the tool, from griptape_tools_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Results per page. Example: 20.

Example input: `{"tool_id":"<tool_id>"}`

### `griptape_tools_list`

List Tools · Read-only

List the Griptape Cloud tools (deployed tool services agents can call).
Returns tools with ID, name, description and latest deployment.
Use this to find a tool.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Results per page. Example: 20.

Example input: `{}`

### `griptape_usage_get`

Get Usage · Read-only

Get Griptape Cloud usage for your organization.
Returns usage totals such as run minutes and tokens for the current period.
Use this to monitor consumption.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `griptape_bucket_asset_url_create`

Create Asset URL · Write

Create a presigned URL to download (GET) or upload (PUT) a file in a Griptape Cloud bucket.
Returns the presigned URL and its expiry.
Use this to read a file's contents or upload a new file directly to storage.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `bucket_id` (`string`, required): ID of the bucket, from griptape_buckets_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.
- `name` (`string`, required): Asset name (path in the bucket). Example: faq.pdf.
- `operation` (`string`, required): GET to download or PUT to upload. Example: GET. One of: `PUT`, `GET`.
- `content_type` (`string`, optional): MIME type for an upload URL, overriding the type guessed from the name. Example: application/pdf.

Example input: `{"bucket_id":"<bucket_id>","name":"<name>","operation":"PUT"}`

### `griptape_bucket_create`

Create Bucket · Write

Create a Griptape Cloud data bucket.
Returns the created bucket with its ID.
Use this to store files for structures and data sources.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Bucket name. Example: support-docs.

Example input: `{"name":"<name>"}`

### `griptape_message_update`

Update Message · Write

Update the input, output or metadata of a Griptape Cloud thread message.
Returns the updated message.
Use this to correct a saved turn.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `message_id` (`string`, required): ID of the message, from griptape_thread_messages_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.
- `input` (`string`, optional): New input text. Example: Where is my order #1001?.
- `metadata` (`object`, optional): Your own key-value metadata as a JSON object. Example: {"team": "support"}
- `output` (`string`, optional): New output text. Example: Order #1001 shipped yesterday.

Example input: `{"message_id":"<message_id>"}`

### `griptape_rule_create`

Create Rule · Write

Create a Griptape Cloud rule: one instruction an agent should follow.
Returns the created rule with its ID.
Use this before adding the rule to a ruleset.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Rule name. Example: Be concise.
- `rule` (`string`, required): The instruction text. Example: Answer in at most three sentences.
- `metadata` (`object`, optional): Your own key-value metadata as a JSON object. Example: {"team": "support"}

Example input: `{"name":"<name>","rule":"<rule>"}`

### `griptape_rule_update`

Update Rule · Write

Update a Griptape Cloud rule's name, text or metadata.
Returns the updated rule.
Use this to change an instruction.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `rule_id` (`string`, required): ID of the rule, from griptape_rules_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.
- `metadata` (`object`, optional): Your own key-value metadata as a JSON object. Example: {"team": "support"}
- `name` (`string`, optional): New name. Example: Be concise.
- `rule` (`string`, optional): New instruction text. Example: Answer in at most two sentences.

Example input: `{"rule_id":"<rule_id>"}`

### `griptape_ruleset_create`

Create Ruleset · Write

Create a Griptape Cloud ruleset from existing rules.
Returns the created ruleset with its ID.
Use this to group rules an agent should follow. Use griptape_rule_create first to create the rules.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Ruleset name. Example: Support tone.
- `alias` (`string`, optional): Unique alias to look the ruleset up by. Example: support-tone.
- `description` (`string`, optional): What the ruleset is for. Example: How the support agent should write.
- `metadata` (`object`, optional): Your own key-value metadata as a JSON object. Example: {"team": "support"}
- `rule_ids` (`array`, optional): IDs of the rules in the ruleset. Example: ["3f1e2d4c-5b6a-4789-9abc-def012345678"]

Example input: `{"name":"<name>"}`

### `griptape_ruleset_update`

Update Ruleset · Write

Update a Griptape Cloud ruleset's name, alias, description, rules or metadata; rule_ids replaces the list.
Returns the updated ruleset.
Use this to add or remove rules from a ruleset.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ruleset_id` (`string`, required): ID of the ruleset, from griptape_rulesets_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.
- `alias` (`string`, optional): New alias. Example: support-tone.
- `description` (`string`, optional): New description. Example: How the support agent should write.
- `metadata` (`object`, optional): Your own key-value metadata as a JSON object. Example: {"team": "support"}
- `name` (`string`, optional): New name. Example: Support tone v2.
- `rule_ids` (`array`, optional): IDs of the rules in the ruleset; replaces the current list. Example: ["3f1e2d4c-5b6a-4789-9abc-def012345678"]

Example input: `{"ruleset_id":"<ruleset_id>"}`

### `griptape_secret_create`

Create Secret · Write

Store a secret value in Griptape Cloud, such as a third-party API key for a structure.
Returns the created secret with its ID (not the value).
Use this before referencing the secret in env_vars with source secret_ref.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Secret name. Example: OPENAI_API_KEY.
- `value` (`string`, required): Secret value. Example: sk-example-value.

Example input: `{"name":"<name>","value":"<value>"}`

### `griptape_secret_update`

Update Secret · Write

Rename a Griptape Cloud secret or replace its value.
Returns the updated secret (not the value).
Use this to rotate a key.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `secret_id` (`string`, required): ID of the secret, from griptape_secrets_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.
- `name` (`string`, optional): New name. Example: OPENAI_API_KEY.
- `value` (`string`, optional): New secret value. Example: sk-new-example-value.

Example input: `{"secret_id":"<secret_id>"}`

### `griptape_structure_run_cancel`

Cancel Structure Run · Write

Cancel a queued or running Griptape Cloud structure run.
Returns the run with status CANCELLED.
Use this to stop a run that is no longer needed.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `structure_run_id` (`string`, required): ID of the structure run, from griptape_structure_runs_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"structure_run_id":"<structure_run_id>"}`

### `griptape_structure_run_create`

Run Structure · Write

Start a run of a Griptape Cloud structure with arguments, such as the user's prompt.
Returns the run with its ID and status (QUEUED or RUNNING).
Use this to call a deployed agent. Use griptape_structure_run_get to wait for the output.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `args` (`array`, required): Positional arguments passed to the structure, such as the prompt. Example: ["Summarize the latest support tickets"]
- `structure_id` (`string`, required): ID of the structure, from griptape_structures_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.
- `env_vars` (`array`, optional): Environment variables for this run, each an object with name, value and source (manual or secret_ref). Example: [{"name": "LOG_LEVEL", "value": "debug", "source": "manual"}]

Example input: `{"args":["Summarize the latest support tickets"],"structure_id":"<structure_id>"}`

### `griptape_structure_update`

Update Structure · Write

Update a Griptape Cloud structure's name, description, webhook setting or environment variables.
Returns the updated structure.
Use this to rename a structure or change its default environment.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `structure_id` (`string`, required): ID of the structure, from griptape_structures_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.
- `description` (`string`, optional): New description. Example: Classifies and routes incoming tickets.
- `env_vars` (`array`, optional): Default environment variables, each an object with name, value and source (manual or secret_ref, where value is a secret ID). Example: [{"name": "LOG_LEVEL", "value": "info", "source": "manual"}]
- `name` (`string`, optional): New name. Example: Support triage agent.
- `webhook_enabled` (`boolean`, optional): True lets the structure be invoked through its webhook URL. Example: false.

Example input: `{"structure_id":"<structure_id>"}`

### `griptape_thread_create`

Create Thread · Write

Create a Griptape Cloud conversation thread for storing an agent's conversation memory.
Returns the created thread with its ID.
Use this to start a conversation. Use griptape_thread_message_create to add turns.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Thread name. Example: Support chat with customer 123.
- `alias` (`string`, optional): Unique alias to look the thread up by. Example: customer-123.
- `metadata` (`object`, optional): Your own key-value metadata as a JSON object. Example: {"team": "support"}

Example input: `{"name":"<name>"}`

### `griptape_thread_message_create`

Create Thread Message · Write

Add a message (one input and output turn) to a Griptape Cloud thread.
Returns the created message with its ID.
Use this to save a conversation turn to memory.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `input` (`string`, required): The user's input for this turn. Example: Where is my order?.
- `output` (`string`, required): The assistant's output for this turn. Example: Your order shipped yesterday and arrives Friday.
- `thread_id` (`string`, required): ID of the thread, from griptape_threads_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.
- `metadata` (`object`, optional): Your own key-value metadata as a JSON object. Example: {"team": "support"}

Example input: `{"input":"<input>","output":"<output>","thread_id":"<thread_id>"}`

### `griptape_thread_update`

Update Thread · Write

Rename a Griptape Cloud thread or change its alias or metadata.
Returns the updated thread.
Use this to tag or rename a conversation.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `thread_id` (`string`, required): ID of the thread, from griptape_threads_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.
- `alias` (`string`, optional): New alias. Example: customer-123.
- `metadata` (`object`, optional): Your own key-value metadata as a JSON object. Example: {"team": "support"}
- `name` (`string`, optional): New name. Example: Support chat (resolved)

Example input: `{"thread_id":"<thread_id>"}`

### `griptape_bucket_asset_delete`

Delete Bucket Asset · Destructive

Delete a file from a Griptape Cloud bucket.
Returns an empty success response.
Use this to remove a stored file.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `bucket_id` (`string`, required): ID of the bucket, from griptape_buckets_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.
- `name` (`string`, required): Asset name (path in the bucket). Example: faq.pdf.

Example input: `{"bucket_id":"<bucket_id>","name":"<name>"}`

### `griptape_bucket_delete`

Delete Bucket · Destructive

Delete a Griptape Cloud bucket and its files.
Returns an empty success response.
Use this to remove stored files for good.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `bucket_id` (`string`, required): ID of the bucket, from griptape_buckets_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"bucket_id":"<bucket_id>"}`

### `griptape_message_delete`

Delete Message · Destructive

Delete a message from a Griptape Cloud thread.
Returns an empty success response.
Use this to remove a turn from memory.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `message_id` (`string`, required): ID of the message, from griptape_thread_messages_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"message_id":"<message_id>"}`

### `griptape_rule_delete`

Delete Rule · Destructive

Delete a Griptape Cloud rule.
Returns an empty success response.
Use this to remove an instruction.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `rule_id` (`string`, required): ID of the rule, from griptape_rules_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"rule_id":"<rule_id>"}`

### `griptape_ruleset_delete`

Delete Ruleset · Destructive

Delete a Griptape Cloud ruleset; its rules are kept.
Returns an empty success response.
Use this to remove a ruleset.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `ruleset_id` (`string`, required): ID of the ruleset, from griptape_rulesets_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"ruleset_id":"<ruleset_id>"}`

### `griptape_secret_delete`

Delete Secret · Destructive

Delete a Griptape Cloud secret.
Returns an empty success response.
Use this to remove a stored key.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `secret_id` (`string`, required): ID of the secret, from griptape_secrets_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"secret_id":"<secret_id>"}`

### `griptape_structure_delete`

Delete Structure · Destructive

Delete a Griptape Cloud structure and its deployments.
Returns an empty success response.
Use this to remove a structure for good.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `structure_id` (`string`, required): ID of the structure, from griptape_structures_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"structure_id":"<structure_id>"}`

### `griptape_thread_delete`

Delete Thread · Destructive

Delete a Griptape Cloud thread and its messages.
Returns an empty success response.
Use this to erase a conversation.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `thread_id` (`string`, required): ID of the thread, from griptape_threads_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"thread_id":"<thread_id>"}`

### `griptape_tool_delete`

Delete Tool · Destructive

Delete a Griptape Cloud tool.
Returns an empty success response.
Use this to remove a tool for good.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `tool_id` (`string`, required): ID of the tool, from griptape_tools_list. Example: 3f1e2d4c-5b6a-4789-9abc-def012345678.

Example input: `{"tool_id":"<tool_id>"}`

## Related

Other AI connectors ([all 216](/agentkit/connectors/?category=ai)):

- [Chorus](/agentkit/connectors/chorus/): Scalekit connector, Username and password, 9 tools
- [Gong](/agentkit/connectors/gong/): Scalekit connector, OAuth, 69 tools
- [Jiminny](/agentkit/connectors/jiminny/): Scalekit connector, Access token, 27 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
