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
- Find the action in the table below, or call
search_one_platform_actions with platform griptape if it is not listed.
- 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.
- 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.
withoneai