← Tools Reference

Griptape

Griptape integration (AI). Imported from open-connector.

API key12 toolshttps://cloud.griptape.ai/api
GET
griptape_list_organizations
List Griptape Cloud organizations accessible to the API key.

/organizations

GET
griptape_get_organization
Retrieve one Griptape Cloud organization by ID.

/organizations/{organization_id}

1 parameter
ParamTypeRequiredDescription
organization_idstringrequiredThe Griptape Cloud organization ID.
GET
griptape_list_assistants
List Griptape Cloud assistants with optional pagination.

/assistants

2 parameters
ParamTypeRequiredDescription
pageintegeroptionalThe page number to request.
page_sizeintegeroptionalThe number of records to request per page.
POST
griptape_create_assistant
Create a Griptape Cloud assistant.

/assistants

9 parameters
ParamTypeRequiredDescription
namestringrequiredThe assistant name.
descriptionstringoptionalThe assistant description.
inputstringoptionalDefault input instructions for the assistant.
modelstringoptionalThe model to use for the assistant.
knowledge_base_idsarrayoptionalKnowledge base IDs to attach to the assistant.
retriever_idsarrayoptionalRetriever IDs to attach to the assistant.
ruleset_idsarrayoptionalRuleset IDs to attach to the assistant.
structure_idsarrayoptionalStructure IDs to attach to the assistant.
tool_idsarrayoptionalTool IDs to attach to the assistant.
GET
griptape_get_assistant
Retrieve one Griptape Cloud assistant by ID.

/assistants/{assistant_id}

1 parameter
ParamTypeRequiredDescription
assistant_idstringrequiredThe Griptape Cloud assistant ID.
PATCH
griptape_update_assistant
Update a Griptape Cloud assistant.

/assistants/{assistant_id}

10 parameters
ParamTypeRequiredDescription
assistant_idstringrequiredThe Griptape Cloud assistant ID.
namestringoptionalThe assistant name.
descriptionstringoptionalThe assistant description.
inputstringoptionalDefault input instructions for the assistant.
modelstringoptionalThe model to use for the assistant.
knowledge_base_idsarrayoptionalKnowledge base IDs to attach to the assistant.
retriever_idsarrayoptionalRetriever IDs to attach to the assistant.
ruleset_idsarrayoptionalRuleset IDs to attach to the assistant.
structure_idsarrayoptionalStructure IDs to attach to the assistant.
tool_idsarrayoptionalTool IDs to attach to the assistant.
DELETE
griptape_delete_assistant
Delete a Griptape Cloud assistant.

/assistants/{assistant_id}

1 parameter
ParamTypeRequiredDescription
assistant_idstringrequiredThe Griptape Cloud assistant ID.
GET
griptape_list_assistant_runs
List runs for a Griptape Cloud assistant.

/assistants/{assistant_id}/runs

4 parameters
ParamTypeRequiredDescription
assistant_idstringrequiredThe Griptape Cloud assistant ID.
pageintegeroptionalThe page number to request.
page_sizeintegeroptionalThe number of records to request per page.
statusarrayoptionalAssistant run statuses to filter by.
POST
griptape_create_assistant_run
Create a run for a Griptape Cloud assistant.

/assistants/{assistant_id}/runs

16 parameters
ParamTypeRequiredDescription
assistant_idstringrequiredThe Griptape Cloud assistant ID.
inputstringoptionalInput text for the assistant run.
argsarrayoptionalArguments for the assistant run.
modelstringoptionalThe model to use for this run.
new_threadbooleanoptionalWhether Griptape Cloud should create a new thread for this run.
thread_idstringoptionalThe existing thread ID to associate with this run.
knowledge_base_idsarrayoptionalKnowledge base IDs to use for this run.
additional_knowledge_base_idsarrayoptionalAdditional knowledge base IDs for this run.
retriever_idsarrayoptionalRetriever IDs to use for this run.
additional_retriever_idsarrayoptionalAdditional retriever IDs for this run.
ruleset_idsarrayoptionalRuleset IDs to use for this run.
additional_ruleset_idsarrayoptionalAdditional ruleset IDs for this run.
structure_idsarrayoptionalStructure IDs to use for this run.
additional_structure_idsarrayoptionalAdditional structure IDs for this run.
tool_idsarrayoptionalTool IDs to use for this run.
additional_tool_idsarrayoptionalAdditional tool IDs for this run.
GET
griptape_get_assistant_run
Retrieve one Griptape Cloud assistant run by ID.

/assistant-runs/{assistant_run_id}

1 parameter
ParamTypeRequiredDescription
assistant_run_idstringrequiredThe Griptape Cloud assistant run ID.
POST
griptape_cancel_assistant_run
Cancel a Griptape Cloud assistant run.

/assistant-runs/{assistant_run_id}/cancel

1 parameter
ParamTypeRequiredDescription
assistant_run_idstringrequiredThe Griptape Cloud assistant run ID.
GET
griptape_list_assistant_events
List non-streaming events for a Griptape Cloud assistant run.

/assistant-runs/{assistant_run_id}/events

3 parameters
ParamTypeRequiredDescription
assistant_run_idstringrequiredThe Griptape Cloud assistant run ID.
limitintegeroptionalThe maximum number of events to return.
offsetintegeroptionalThe event offset to start from.