griptape

name

griptape

description

Griptape is an AI application framework that provides tools, workflows, and abstractions for building and orchestrating LLM-powered agents and data-aware applications, allowing developers to integrate models, external systems, and memory into structured, production-oriented automation. Read and write Griptape data through One: structureruns, functions, structures, retrievers, tools, apikeys and more, 188 actions with real parameter documentation. Use whenever the user asks to look something up in Griptape, create or update a record there, or build code against the Griptape API.

Griptape through One

Griptape is an AI application framework that provides tools, workflows, and abstractions for building and orchestrating LLM-powered agents and data-aware applications, allowing developers to integrate models, external systems, and memory into structured, production-oriented automation.

One exposes Griptape through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform griptape if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Griptape is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Griptape account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

StructureRuns

Action	Method	Path	Action id
Get a Structure Run	GET	/structure-runs/{{structureRunId}}	conn_mod_def::GKp5ZI0oSMA::UMS8hNMSQX6JLLn2fvnHlA
Get a Structure Run's Events SSE Stream	GET	/structure-runs/{{structureRunId}}/events/stream	conn_mod_def::GKp5TvcQpHg::BGE_LK1oRiuDdSDarMzb8Q
List a Structure Run's Logs	GET	/structure-runs/{{structureRunId}}/logs	conn_mod_def::GKp5ZVXqMJg::NCm8MoS9TDu1fkyrPBTx1Q
List a Structure's Runs	GET	/structures/{{structureId}}/runs	conn_mod_def::GKp5ZR6Blsg::tg2O_GjwT6qKQ6cIybeDXQ
Cancel a Structure Run	POST	/structure-runs/{{structureRunId}}/cancel	conn_mod_def::GKp5ZIaq-8g::8UVZdbbES9q43aGDbSJelA
Create a Structure Run	POST	/structures/{{structureId}}/runs	conn_mod_def::GKp5ZBqYmgg::TjgJUNTjQ3uBiMwG7GwMbA
Create Events for a Structure Run	POST	/structure-runs/{{structureRunId}}/events	conn_mod_def::GKp5TcYTILg::Gb8-kVC8RB-d2T8MJOAnJw

Functions

Action	Method	Path	Action id
Execute a Function by ID	GET	/functions/{{functionId}}/execute	conn_mod_def::GKp5T4GBLdA::Yz5k2YURQ_2y21LRtyizZg
Get a Function	GET	/functions/{{functionId}}	conn_mod_def::GKp5UVLGM_g::FHocfeXpSteHyqc1JHk5zQ
List Functions	GET	/functions	conn_mod_def::GKp5Ud0cikg::cQuXg7q6TR2cSlhJIkH1vw
Create Function	POST	/api/functions	conn_mod_def::GKp5UUsx4VA::MB_KToFXRN6br7y4gWn3kA
Delete a Function	DELETE	/functions/{{functionId}}	conn_mod_def::GKp5UUdxL9A::o5mch2WVR8y5eDVSjkSwhg
Execute a Function	POST	/functions/{{functionId}}/execute	conn_mod_def::GKp5T45w5pg::dmPa5nCzRVaFcDNlWhpTRw
Update a Function	PATCH	/functions/{{functionId}}	conn_mod_def::GKp5UdeZArg::6l_Yw9IpR4S3L6NjpEXuEg

Structures

Action	Method	Path	Action id
Get a Structure	GET	/structures/{{structureId}}	conn_mod_def::GKp5ZTrci8A::mpyse8tgQreZZeZU8UF0kQ
Invoke a Structure Webhook	GET	/structures/{{structureId}}/webhook	conn_mod_def::GKp5Zi95ytA::CmqSvyotSDe0UXSy8voyYw
List Structures	GET	/api/structures	conn_mod_def::GKp5ZmYXvbg::geuXXokdT0SFnirRWbnLfQ
Create Structure	POST	/api/structures	conn_mod_def::GKp5ZRaacQA::zyJr4GIDQAOfPN6LG5Oufg
Delete a Structure	DELETE	/structures/{{structureId}}	conn_mod_def::GKp5ZXPwHkA::8uBXcaIZRhSovz6lZKA1hw
Invoke a Structure Webhook	POST	/structures/{{structureId}}/webhook	conn_mod_def::GKp5ZqNPijA::aqRke7GSTq2NswfLUzuLjw
Update a Structure	PATCH	/structures/{{structureId}}	conn_mod_def::GKp5ZjZA-dg::S7S4ejowSeKerjFYrWmgfQ

Retrievers

Action	Method	Path	Action id
Get a Retriever	GET	/retrievers/{{retrieverId}}	conn_mod_def::GKp5YI_zhwg::VEj8o9bhTQGtDOgz0DN7JQ
List Retrievers	GET	/api/retrievers	conn_mod_def::GKp5YPQQ89g::n7pjn9ZuSrmEXXv-tK5P0g
Create Retriever	POST	/api/retrievers	conn_mod_def::GKp5YIvz7_g::vDapi3NGSRajEubJXBVGZg
Delete a Retriever	DELETE	/retrievers/{{retrieverId}}	conn_mod_def::GKp5YHwf82A::nkcFLc0ETBGv3wjThDQM2Q
Query a Retriever	POST	/retrievers/{{retrieverId}}/query	conn_mod_def::GKp5YNh6TMg::8wXZ8hHUSSydBv37ZVA-Vg
Update a Retriever	PATCH	/retrievers/{{retrieverId}}	conn_mod_def::GKp5YaTWBQA::xIkByBjmQBW_qTn_V0CjJQ

Tools

Action	Method	Path	Action id
Get a Tool	GET	/tools/{{toolId}}	conn_mod_def::GKp5aPb68vg::zPiHKlsqS4CEbZcPIZkVeg
Get a Tool's OpenAPI Run	GET	/tools/{{toolId}}/openapi	conn_mod_def::GKp5aGa0Gqg::ukELJzmUSUaW6U-xr4iCTA
List Tools	GET	/api/tools	conn_mod_def::GKp5aRlXUhA::jIBB2CSPTQCG1ivWmAmChQ
Create Tool	POST	/api/tools	conn_mod_def::GKp5aPMb69g::ua-fwVd_RF6n-Kpe4pvKCw
Delete a Tool	DELETE	/tools/{{toolId}}	conn_mod_def::GKp5aPMjeXA::cPYc29m3R2i8vjV54vt5ng
Update a Tool	PATCH	/tools/{{toolId}}	conn_mod_def::GKp5aVb6U9g::KZV0X6eJTdWKkWvZ5INlIg

ApiKeys

Action	Method	Path	Action id
Get an API Key	GET	/api-keys/{{apiKeyId}}	conn_mod_def::GKp5RBO_a3g::RTt7qA5-QjW50ohqI8TNUQ
List a User's API Keys	GET	/users/{{userId}}/api-keys	conn_mod_def::GKp5RF_mxBA::JIQ3heYiRQK0XDwCE0YQ3A
List an Organization's API Keys	GET	/organizations/{{organizationId}}/api-keys	conn_mod_def::GKp5RQgHyBA::dKZOZrX5RUuGDCLSghtEuA
Delete API Key	DELETE	/api/api-keys/{{apiKeyId}}	conn_mod_def::GKp5RHh1P-g::mDT9BMQnRV64CoDHXCNdWA
Update an API Key	PATCH	/api/api-keys/{{apiKeyId}}	conn_mod_def::GKp5RQWCSfg::KQ62v6pqQjGjJJFpaT8y1g

AssistantRuns

Action	Method	Path	Action id
Get an Assistant Run	GET	/assistant-runs/{{assistantRunId}}	conn_mod_def::GKp5RfOT97g::nbXs4baLSjKGYUWkuk1rSw
Get an Assistant Run's Events Stream	GET	/assistant-runs/{{assistantRunId}}/events/stream	conn_mod_def::GKp5TaTp2tA::Uj-nLoLARN-EwwGIOjZ3dw
List an Assistant's Runs	GET	/assistants/{{assistantId}}/runs	conn_mod_def::GKp5RyAiJvA::U68IliYJRe2gJSi-on83lQ
Cancel an Assistant Run	POST	/assistant-runs/{{assistantRunId}}/cancel	conn_mod_def::GKp5RfmimKg::mPpgHJ6rSbmdfJJ2hqA4EQ
Create an Assistant Run	POST	/assistants/{{assistantId}}/runs	conn_mod_def::GKp5RfnCUcA::rrrGDnBPTaqFKl1taN46ew

Assistants

Action	Method	Path	Action id
Get an Assistant	GET	/assistants/{{assistantId}}	conn_mod_def::GKp5Rxdbbsg::fHKmD9ixQXSFafu2n503sA
List Assistants	GET	/api/assistants	conn_mod_def::GKp5RxxDpKA::ur66D4aRRc2Dyn_1KuFFLQ
Create Assistant	POST	/api/assistants	conn_mod_def::GKp5RxDROSA::5F3KaaFVTjiQd3n47kJ-HQ
Delete an Assistant	DELETE	/assistants/{{assistantId}}	conn_mod_def::GKp5RxCoSKg::0Qdm4hW8SCGBTHxcE6xnBg
Update an Assistant	PATCH	/assistants/{{assistantId}}	conn_mod_def::GKp5R8Tyx3A::DrSU2wkBR1GRAhzQHc327Q

Buckets

Action	Method	Path	Action id
Get a Bucket	GET	/buckets/{{bucketId}}	conn_mod_def::GKp5SIOK1RA::eTuHvK2RTI6EXdcBom0Heg
List Buckets	GET	/api/buckets	conn_mod_def::GKp5SFzxm1A::2V-JSgntS0yLwzVYjr_kXw
Create Bucket	POST	/api/buckets	conn_mod_def::GKp5R6UI14g::Ss2sBXI-Q1WyjliPag_wzg
Delete Bucket	DELETE	/buckets/{{bucketId}}	conn_mod_def::GKp5R6ppQtA::M8ezr7S0S_yxXCz2_YhBJQ
Update a Bucket	PATCH	/buckets/{{bucketId}}	conn_mod_def::GKp5SFs9V7g::hYis63D_ScOZPsPP8jCQwg

Integrations

Action	Method	Path	Action id
Get an Integration	GET	/integrations/{{integrationId}}	conn_mod_def::GKp5UncwPDg::lWwZRmvpS56tDEe0-dSOOg
List Integrations	GET	/api/integrations	conn_mod_def::GKp5U9mBX9g::pBX9Pgi4RW-WzbXGiAukAw
Create Integration	POST	/api/integrations	conn_mod_def::GKp5UuxK50g::w_AYOQMkThayFwQVSyj1YA
Delete an Integration	DELETE	/integrations/{{integrationId}}	conn_mod_def::GKp5UtiE_6A::LkAkq4RfRsS3F3mEMZBqvQ
Update an Integration	PATCH	/integrations/{{integrationId}}	conn_mod_def::GKp5U6N22yA::CJ0iKyVYQAKWq3GPDBYXLw

Libraries

Action	Method	Path	Action id
Get a Library	GET	/libraries/{{libraryId}}	conn_mod_def::GKp5WFURQNg::iU0VGVVmTmOokzd3HCcX7Q
List Libraries	GET	/api/libraries	conn_mod_def::GKp5WMMstSA::6edgcC1nTtiR-CuVCNR7ZQ
Create Library	POST	/api/libraries	conn_mod_def::GKp5V9ZtTQg::nnp1eWNkTi2rjX1-FhV6cA
Delete a Library	DELETE	/libraries/{{libraryId}}	conn_mod_def::GKp5V3-Vy2g::FuOUz7lJQdCOY5jOsYWL8g
Update a Library	PATCH	/libraries/{{libraryId}}	conn_mod_def::GKp5WMPh1FA::hN_02G-HQSKu46B6pQbhIw

Models

Action	Method	Path	Action id
Get a Model Configuration	GET	/models/{{modelConfigId}}	conn_mod_def::GKp5WjdYsXg::VLMDAEbXRLG-qJnP4IHnWw
List Models	GET	/api/models	conn_mod_def::GKp5XfcAKAA::j6xbLRXkQImpdAdcr17j1A
Create Model	POST	/api/models	conn_mod_def::GKp5WU9P1GA::O0n7HUJQQzGJ5weVx_DMnA
Delete Model	DELETE	/models/{{modelConfigId}}	conn_mod_def::GKp5Wm4Dw8A::F3dhDPOXT9SJ3Ay2kv9IMw
Update a Model	PATCH	/models/{{modelConfigId}}	conn_mod_def::GKp5XjlxxPA::j_OCXvAVS3KFnpc0WwhVNA

AuthConfigs

Action	Method	Path	Action id
Get an Auth Config	GET	/models/auth-configs/{{authConfigId}}	conn_mod_def::GKp5WjybtWg::L2j7RKtZSLC-OFIhI8XOeQ
List Auth Configs	GET	/api/models/auth-configs	conn_mod_def::GKp5WrdDRng::vU-Vl_hmSrG5BNrZD9Zg1Q
Create Auth Config	POST	/api/models/auth-configs	conn_mod_def::GKp5WViip7g::C2KoLTo2R_KAwBOGNdkQsg
Delete an Auth Config	DELETE	/models/auth-configs/{{authConfigId}}	conn_mod_def::GKp5XVCYo3A::6Vk7Kbt_QbeUWY23QoNbyA
Update an Auth Config	PATCH	/models/auth-configs/{{authConfigId}}	conn_mod_def::GKp5XgMMSxA::OJAcM7A_REOhy-FYYbnFHg

Organizations

Action	Method	Path	Action id
Get an Organization	GET	/organizations/{{organizationId}}	conn_mod_def::GKp5Xrl8PgA::LWpR8itNT7e1GJ5G0-21FQ
List Organizations	GET	/api/organizations	conn_mod_def::GKp5Xrl1aAA::zSxB-cmGR6y4t4HUiT_q3Q
Create Organization	POST	/api/organizations	conn_mod_def::GKp5XjcrvPA::4CZF_Km4Roq_MUJq0eD2NQ
Delete an Organization	DELETE	/organizations/{{organizationId}}	conn_mod_def::GKp5Xe8ki1g::w53aQaGhRQqA9Vt9Sg4LgA
Update an Organization	PATCH	/organizations/{{organizationId}}	conn_mod_def::GKp5XudhETg::BMm8gg0NTEObpopS5fHBSA

RetrieverComponents

Action	Method	Path	Action id
Get a Retriever Component	GET	/retriever-components/{{retrieverComponentId}}	conn_mod_def::GKp5X8-8eyA::i9FcX9mIRzSJikzQx9EB1g
List Retriever Components	GET	/api/retriever-components	conn_mod_def::GKp5X6huNbg::qTS3E40yTSeLTbXTRcSjEw
Create Retriever Component	POST	/api/retriever-components	conn_mod_def::GKp5YAiAT5A::iaqkWxypTBmIP0qQVzCmRg
Delete a Retriever Component	DELETE	/retriever-components/{{retrieverComponentId}}	conn_mod_def::GKp5X8fUgmg::X0EsCxN3RF-u9arWpbYVPw
Update a Retriever Component	PATCH	/retriever-components/{{retrieverComponentId}}	conn_mod_def::GKp5X3tpStA::kkWLFb__RRazC2j01kS04Q

Rules

Action	Method	Path	Action id
Get a Rule	GET	/rules/{{ruleId}}	conn_mod_def::GKp5YXAO-OA::xqLWJHOySXOrYaBFubsr7Q
List Rules	GET	/api/rules	conn_mod_def::GKp5YZgJoxg::sjBGn-gVTgCGM5sm_RmLpA
Create Rule	POST	/api/rules	conn_mod_def::GKp5YZhRlRA::XiQ7n4RDRfirjdImKTcjkA
Delete a Rule	DELETE	/rules/{{ruleId}}	conn_mod_def::GKp5YXo0HBA::n19Y0-ppR-6e7YWdb29oRQ
Update a Rule	PATCH	/rules/{{ruleId}}	conn_mod_def::GKp5YmImSJA::a3Y4ikt_TOmkvAWBCbNT7g

Rulesets

Action	Method	Path	Action id
Get a Ruleset	GET	/rulesets/{{rulesetId}}	conn_mod_def::GKp5Yix7Ekg::E2j6TR1wR0io9r3UgoQ8nw
List Rulesets	GET	/api/rulesets	conn_mod_def::GKp5YkZqI9g::p-gTR2uFRCuNqCHJJh0O5Q

3 more Rulesets actions are available through search.

This lists 90 of 188 actions. For anything not here, call search_one_platform_actions with platform griptape. The full catalog is at https://www.withone.ai/knowledge/griptape.

When a call fails

The error comes from Griptape, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/griptape

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.