# Tools

## Get Custom Tools

> Get all custom tool providers for the user's organization.\
> \
> Args:\
>     user\_org: Current authenticated user\
>     service: Custom tool service instance\
> \
> Returns:\
>     List of custom tool providers

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"security":[{"OAuth2PasswordBearer":[]}],"components":{"securitySchemes":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"token"}}}},"schemas":{"ToolProviderSchema":{"properties":{"provider_id":{"type":"string","title":"Provider Id"},"provider_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Version"},"provider_group":{"anyOf":[{"items":{"$ref":"#/components/schemas/ProviderGroupEnum"},"type":"array"},{"type":"null"}],"title":"Provider Group"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"icon":{"type":"string","title":"Icon"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"color":{"type":"string","title":"Color","default":"#A3A3A3"},"triggers":{"items":{"$ref":"#/components/schemas/TriggerSchema"},"type":"array","title":"Triggers"},"actions":{"items":{"$ref":"#/components/schemas/ActionSchema"},"type":"array","title":"Actions"},"connections":{"anyOf":[{"items":{"$ref":"#/components/schemas/AvailableConnection"},"type":"array"},{"type":"null"}],"title":"Connections"},"deprecation_info":{"anyOf":[{"$ref":"#/components/schemas/DeprecationInfo"},{"type":"null"}]},"openapi_schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Openapi Schema"},"headers":{"anyOf":[{"items":{"$ref":"#/components/schemas/HeaderSchema"},"type":"array"},{"type":"null"}],"title":"Headers"}},"type":"object","required":["provider_id","provider_version","provider_group","name","description","icon","tags","triggers","actions","connections","openapi_schema","headers"],"title":"ToolProviderSchema"},"ProviderGroupEnum":{"type":"string","enum":["LLM","SCRAPER","BY_STACK_AI","APPS","DATABASE"],"title":"ProviderGroupEnum"},"TriggerSchema":{"properties":{"trigger_id":{"type":"string","title":"Trigger Id"},"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"},"input_params":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Input Params"},"output_params":{"items":{"$ref":"#/components/schemas/ToolOutputParameterSchema"},"type":"array","title":"Output Params"},"api_tool_info":{"anyOf":[{"$ref":"#/components/schemas/ApiToolInfo"},{"type":"null"}]}},"type":"object","required":["trigger_id","provider_id","name","description","input_params","output_params","api_tool_info"],"title":"TriggerSchema"},"ToolInputParameterSchema":{"properties":{"label":{"type":"string","title":"Label"},"type":{"type":"string","title":"Type"},"form":{"type":"string","title":"Form"},"required":{"type":"boolean","title":"Required"},"llm_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Description"},"human_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Human Description"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"placeholder":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Placeholder"},"min":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Min"},"max":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Max"},"options":{"items":{},"type":"array","title":"Options","default":[]},"default":{"anyOf":[{},{"type":"null"}],"title":"Default"},"has_dynamic_options":{"type":"boolean","title":"Has Dynamic Options","default":false},"depends_on":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Depends On"}},"type":"object","required":["label","type","form","required","llm_description","human_description","name","placeholder","min","max"],"title":"ToolInputParameterSchema"},"ToolOutputParameterSchema":{"properties":{"label":{"type":"string","title":"Label"},"type":{"type":"string","title":"Type"},"llm_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Description"},"human_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Human Description"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["label","type","llm_description","human_description","name"],"title":"ToolOutputParameterSchema"},"ApiToolInfo":{"properties":{"id":{"type":"string","title":"Id"},"server_url_with_path":{"type":"string","title":"Server Url With Path"},"method":{"type":"string","title":"Method"},"path":{"type":"string","title":"Path"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"parameters":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Parameters","default":[]},"headers":{"items":{"$ref":"#/components/schemas/HeaderSchema"},"type":"array","title":"Headers","default":[]}},"type":"object","required":["id","server_url_with_path","method","path"],"title":"ApiToolInfo","description":"Class for storing API tool schema information.\n\nStores metadata about an API-based tool including:\n- Server URL\n- Operation ID\n- HTTP method\n- Summary\n- Parameters\n- OpenAPI operation details"},"HeaderSchema":{"properties":{"order":{"type":"integer","title":"Order"},"key":{"type":"string","title":"Key"},"value":{"type":"string","title":"Value"}},"type":"object","required":["order","key","value"],"title":"HeaderSchema"},"ActionSchema":{"properties":{"action_id":{"type":"string","title":"Action Id"},"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"description":{"$ref":"#/components/schemas/ActionDescription"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","default":[]},"input_params":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Input Params"},"output_params":{"items":{"$ref":"#/components/schemas/ToolOutputParameterSchema"},"type":"array","title":"Output Params"},"api_tool_info":{"anyOf":[{"$ref":"#/components/schemas/ApiToolInfo"},{"type":"null"}]}},"type":"object","required":["action_id","provider_id","name","description","input_params","output_params","api_tool_info"],"title":"ActionSchema"},"ActionDescription":{"properties":{"human":{"type":"string","title":"Human","description":"The description shown to the user"},"llm":{"type":"string","maxLength":2048,"title":"Llm","description":"The description shown to the LLM"}},"type":"object","required":["human","llm"],"title":"ActionDescription"},"AvailableConnection":{"properties":{"connection_type_id":{"type":"string","title":"Connection Type Id"},"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"labels":{"items":{"type":"string"},"type":"array","title":"Labels"},"params":{"items":{"$ref":"#/components/schemas/ConnectionParameter"},"type":"array","title":"Params"},"minimum_plan":{"type":"string","title":"Minimum Plan"},"color":{"type":"string","title":"Color","default":"#A3A3A3"},"is_marketing_stunt":{"type":"boolean","title":"Is Marketing Stunt","default":false},"connection_type":{"$ref":"#/components/schemas/ConnectionType","default":"credentials"}},"type":"object","required":["connection_type_id","provider_id","name","description","labels","params","minimum_plan"],"title":"AvailableConnection"},"ConnectionParameter":{"properties":{"label":{"type":"string","title":"Label"},"type":{"$ref":"#/components/schemas/ToolParameterType","default":"string"},"placeholder":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Placeholder"},"default":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Default"},"help":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Help"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"required":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Required","default":true},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["label"],"title":"ConnectionParameter"},"ToolParameterType":{"type":"string","enum":["string","number","integer","float","boolean","select","secret","secret_multiline","file","files","knowledge_base","connection","textarea","multiple_select","string_array","number_array","date","datetime","object","object_array","dict","dict_array","code"],"title":"ToolParameterType"},"ConnectionType":{"type":"string","enum":["oauth","oauth_custom_credentials","credentials","ntlm","sqs"],"title":"ConnectionType"},"DeprecationInfo":{"properties":{"date_will_be_removed":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date Will Be Removed"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"}},"type":"object","title":"DeprecationInfo"}}},"paths":{"/tools/custom":{"get":{"tags":["tools","custom-tools"],"summary":"Get Custom Tools","description":"Get all custom tool providers for the user's organization.\n\nArgs:\n    user_org: Current authenticated user\n    service: Custom tool service instance\n\nReturns:\n    List of custom tool providers","operationId":"get_custom_tools_tools_custom_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ToolProviderSchema"},"type":"array","title":"Response Get Custom Tools Tools Custom Get"}}}}}}}}}
```

## Create Custom Tool

> Create a new custom tool provider.\
> \
> Args:\
>     data: Provider creation data\
>     service: Custom tool service instance\
>     user\_org: Current user's organization\
>     user: Current user profile\
> \
> Returns:\
>     Created custom tool provider

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"security":[{"OAuth2PasswordBearer":[]}],"components":{"securitySchemes":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"token"}}}},"schemas":{"CreateToolProviderSchema":{"properties":{"name":{"type":"string","title":"Name"},"icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon"},"api_schema":{"type":"string","title":"Api Schema"},"apis":{"items":{"$ref":"#/components/schemas/ApiEndpointSchema"},"type":"array","title":"Apis"},"headers":{"items":{"$ref":"#/components/schemas/HeaderSchema"},"type":"array","title":"Headers"},"dereferenced_schema":{"title":"Dereferenced Schema"}},"type":"object","required":["name","icon","api_schema","apis","headers","dereferenced_schema"],"title":"CreateToolProviderSchema"},"ApiEndpointSchema":{"properties":{"server_url":{"type":"string","title":"Server Url"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"method":{"type":"string","title":"Method"},"path":{"type":"string","title":"Path"}},"type":"object","required":["server_url","name","description","method","path"],"title":"ApiEndpointSchema"},"HeaderSchema":{"properties":{"order":{"type":"integer","title":"Order"},"key":{"type":"string","title":"Key"},"value":{"type":"string","title":"Value"}},"type":"object","required":["order","key","value"],"title":"HeaderSchema"},"ToolProviderSchema":{"properties":{"provider_id":{"type":"string","title":"Provider Id"},"provider_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Version"},"provider_group":{"anyOf":[{"items":{"$ref":"#/components/schemas/ProviderGroupEnum"},"type":"array"},{"type":"null"}],"title":"Provider Group"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"icon":{"type":"string","title":"Icon"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"color":{"type":"string","title":"Color","default":"#A3A3A3"},"triggers":{"items":{"$ref":"#/components/schemas/TriggerSchema"},"type":"array","title":"Triggers"},"actions":{"items":{"$ref":"#/components/schemas/ActionSchema"},"type":"array","title":"Actions"},"connections":{"anyOf":[{"items":{"$ref":"#/components/schemas/AvailableConnection"},"type":"array"},{"type":"null"}],"title":"Connections"},"deprecation_info":{"anyOf":[{"$ref":"#/components/schemas/DeprecationInfo"},{"type":"null"}]},"openapi_schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Openapi Schema"},"headers":{"anyOf":[{"items":{"$ref":"#/components/schemas/HeaderSchema"},"type":"array"},{"type":"null"}],"title":"Headers"}},"type":"object","required":["provider_id","provider_version","provider_group","name","description","icon","tags","triggers","actions","connections","openapi_schema","headers"],"title":"ToolProviderSchema"},"ProviderGroupEnum":{"type":"string","enum":["LLM","SCRAPER","BY_STACK_AI","APPS","DATABASE"],"title":"ProviderGroupEnum"},"TriggerSchema":{"properties":{"trigger_id":{"type":"string","title":"Trigger Id"},"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"},"input_params":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Input Params"},"output_params":{"items":{"$ref":"#/components/schemas/ToolOutputParameterSchema"},"type":"array","title":"Output Params"},"api_tool_info":{"anyOf":[{"$ref":"#/components/schemas/ApiToolInfo"},{"type":"null"}]}},"type":"object","required":["trigger_id","provider_id","name","description","input_params","output_params","api_tool_info"],"title":"TriggerSchema"},"ToolInputParameterSchema":{"properties":{"label":{"type":"string","title":"Label"},"type":{"type":"string","title":"Type"},"form":{"type":"string","title":"Form"},"required":{"type":"boolean","title":"Required"},"llm_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Description"},"human_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Human Description"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"placeholder":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Placeholder"},"min":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Min"},"max":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Max"},"options":{"items":{},"type":"array","title":"Options","default":[]},"default":{"anyOf":[{},{"type":"null"}],"title":"Default"},"has_dynamic_options":{"type":"boolean","title":"Has Dynamic Options","default":false},"depends_on":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Depends On"}},"type":"object","required":["label","type","form","required","llm_description","human_description","name","placeholder","min","max"],"title":"ToolInputParameterSchema"},"ToolOutputParameterSchema":{"properties":{"label":{"type":"string","title":"Label"},"type":{"type":"string","title":"Type"},"llm_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Description"},"human_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Human Description"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["label","type","llm_description","human_description","name"],"title":"ToolOutputParameterSchema"},"ApiToolInfo":{"properties":{"id":{"type":"string","title":"Id"},"server_url_with_path":{"type":"string","title":"Server Url With Path"},"method":{"type":"string","title":"Method"},"path":{"type":"string","title":"Path"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"parameters":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Parameters","default":[]},"headers":{"items":{"$ref":"#/components/schemas/HeaderSchema"},"type":"array","title":"Headers","default":[]}},"type":"object","required":["id","server_url_with_path","method","path"],"title":"ApiToolInfo","description":"Class for storing API tool schema information.\n\nStores metadata about an API-based tool including:\n- Server URL\n- Operation ID\n- HTTP method\n- Summary\n- Parameters\n- OpenAPI operation details"},"ActionSchema":{"properties":{"action_id":{"type":"string","title":"Action Id"},"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"description":{"$ref":"#/components/schemas/ActionDescription"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","default":[]},"input_params":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Input Params"},"output_params":{"items":{"$ref":"#/components/schemas/ToolOutputParameterSchema"},"type":"array","title":"Output Params"},"api_tool_info":{"anyOf":[{"$ref":"#/components/schemas/ApiToolInfo"},{"type":"null"}]}},"type":"object","required":["action_id","provider_id","name","description","input_params","output_params","api_tool_info"],"title":"ActionSchema"},"ActionDescription":{"properties":{"human":{"type":"string","title":"Human","description":"The description shown to the user"},"llm":{"type":"string","maxLength":2048,"title":"Llm","description":"The description shown to the LLM"}},"type":"object","required":["human","llm"],"title":"ActionDescription"},"AvailableConnection":{"properties":{"connection_type_id":{"type":"string","title":"Connection Type Id"},"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"labels":{"items":{"type":"string"},"type":"array","title":"Labels"},"params":{"items":{"$ref":"#/components/schemas/ConnectionParameter"},"type":"array","title":"Params"},"minimum_plan":{"type":"string","title":"Minimum Plan"},"color":{"type":"string","title":"Color","default":"#A3A3A3"},"is_marketing_stunt":{"type":"boolean","title":"Is Marketing Stunt","default":false},"connection_type":{"$ref":"#/components/schemas/ConnectionType","default":"credentials"}},"type":"object","required":["connection_type_id","provider_id","name","description","labels","params","minimum_plan"],"title":"AvailableConnection"},"ConnectionParameter":{"properties":{"label":{"type":"string","title":"Label"},"type":{"$ref":"#/components/schemas/ToolParameterType","default":"string"},"placeholder":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Placeholder"},"default":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Default"},"help":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Help"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"required":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Required","default":true},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["label"],"title":"ConnectionParameter"},"ToolParameterType":{"type":"string","enum":["string","number","integer","float","boolean","select","secret","secret_multiline","file","files","knowledge_base","connection","textarea","multiple_select","string_array","number_array","date","datetime","object","object_array","dict","dict_array","code"],"title":"ToolParameterType"},"ConnectionType":{"type":"string","enum":["oauth","oauth_custom_credentials","credentials","ntlm","sqs"],"title":"ConnectionType"},"DeprecationInfo":{"properties":{"date_will_be_removed":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date Will Be Removed"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"}},"type":"object","title":"DeprecationInfo"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/tools/custom":{"post":{"tags":["tools","custom-tools"],"summary":"Create Custom Tool","description":"Create a new custom tool provider.\n\nArgs:\n    data: Provider creation data\n    service: Custom tool service instance\n    user_org: Current user's organization\n    user: Current user profile\n\nReturns:\n    Created custom tool provider","operationId":"create_custom_tool_tools_custom_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateToolProviderSchema"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolProviderSchema"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Update Custom Tool

> Update an existing custom tool provider.\
> \
> Args:\
>     provider\_id: Provider ID to update\
>     data: Provider update data\
>     service: Custom tool service instance\
>     user\_org: Current user's organization\
>     user: Current user profile\
> \
> Returns:\
>     Updated custom tool provider

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"security":[{"OAuth2PasswordBearer":[]}],"components":{"securitySchemes":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"token"}}}},"schemas":{"CreateToolProviderSchema":{"properties":{"name":{"type":"string","title":"Name"},"icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon"},"api_schema":{"type":"string","title":"Api Schema"},"apis":{"items":{"$ref":"#/components/schemas/ApiEndpointSchema"},"type":"array","title":"Apis"},"headers":{"items":{"$ref":"#/components/schemas/HeaderSchema"},"type":"array","title":"Headers"},"dereferenced_schema":{"title":"Dereferenced Schema"}},"type":"object","required":["name","icon","api_schema","apis","headers","dereferenced_schema"],"title":"CreateToolProviderSchema"},"ApiEndpointSchema":{"properties":{"server_url":{"type":"string","title":"Server Url"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"method":{"type":"string","title":"Method"},"path":{"type":"string","title":"Path"}},"type":"object","required":["server_url","name","description","method","path"],"title":"ApiEndpointSchema"},"HeaderSchema":{"properties":{"order":{"type":"integer","title":"Order"},"key":{"type":"string","title":"Key"},"value":{"type":"string","title":"Value"}},"type":"object","required":["order","key","value"],"title":"HeaderSchema"},"ToolProviderSchema":{"properties":{"provider_id":{"type":"string","title":"Provider Id"},"provider_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Version"},"provider_group":{"anyOf":[{"items":{"$ref":"#/components/schemas/ProviderGroupEnum"},"type":"array"},{"type":"null"}],"title":"Provider Group"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"icon":{"type":"string","title":"Icon"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"color":{"type":"string","title":"Color","default":"#A3A3A3"},"triggers":{"items":{"$ref":"#/components/schemas/TriggerSchema"},"type":"array","title":"Triggers"},"actions":{"items":{"$ref":"#/components/schemas/ActionSchema"},"type":"array","title":"Actions"},"connections":{"anyOf":[{"items":{"$ref":"#/components/schemas/AvailableConnection"},"type":"array"},{"type":"null"}],"title":"Connections"},"deprecation_info":{"anyOf":[{"$ref":"#/components/schemas/DeprecationInfo"},{"type":"null"}]},"openapi_schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Openapi Schema"},"headers":{"anyOf":[{"items":{"$ref":"#/components/schemas/HeaderSchema"},"type":"array"},{"type":"null"}],"title":"Headers"}},"type":"object","required":["provider_id","provider_version","provider_group","name","description","icon","tags","triggers","actions","connections","openapi_schema","headers"],"title":"ToolProviderSchema"},"ProviderGroupEnum":{"type":"string","enum":["LLM","SCRAPER","BY_STACK_AI","APPS","DATABASE"],"title":"ProviderGroupEnum"},"TriggerSchema":{"properties":{"trigger_id":{"type":"string","title":"Trigger Id"},"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"},"input_params":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Input Params"},"output_params":{"items":{"$ref":"#/components/schemas/ToolOutputParameterSchema"},"type":"array","title":"Output Params"},"api_tool_info":{"anyOf":[{"$ref":"#/components/schemas/ApiToolInfo"},{"type":"null"}]}},"type":"object","required":["trigger_id","provider_id","name","description","input_params","output_params","api_tool_info"],"title":"TriggerSchema"},"ToolInputParameterSchema":{"properties":{"label":{"type":"string","title":"Label"},"type":{"type":"string","title":"Type"},"form":{"type":"string","title":"Form"},"required":{"type":"boolean","title":"Required"},"llm_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Description"},"human_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Human Description"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"placeholder":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Placeholder"},"min":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Min"},"max":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Max"},"options":{"items":{},"type":"array","title":"Options","default":[]},"default":{"anyOf":[{},{"type":"null"}],"title":"Default"},"has_dynamic_options":{"type":"boolean","title":"Has Dynamic Options","default":false},"depends_on":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Depends On"}},"type":"object","required":["label","type","form","required","llm_description","human_description","name","placeholder","min","max"],"title":"ToolInputParameterSchema"},"ToolOutputParameterSchema":{"properties":{"label":{"type":"string","title":"Label"},"type":{"type":"string","title":"Type"},"llm_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Description"},"human_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Human Description"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["label","type","llm_description","human_description","name"],"title":"ToolOutputParameterSchema"},"ApiToolInfo":{"properties":{"id":{"type":"string","title":"Id"},"server_url_with_path":{"type":"string","title":"Server Url With Path"},"method":{"type":"string","title":"Method"},"path":{"type":"string","title":"Path"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"parameters":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Parameters","default":[]},"headers":{"items":{"$ref":"#/components/schemas/HeaderSchema"},"type":"array","title":"Headers","default":[]}},"type":"object","required":["id","server_url_with_path","method","path"],"title":"ApiToolInfo","description":"Class for storing API tool schema information.\n\nStores metadata about an API-based tool including:\n- Server URL\n- Operation ID\n- HTTP method\n- Summary\n- Parameters\n- OpenAPI operation details"},"ActionSchema":{"properties":{"action_id":{"type":"string","title":"Action Id"},"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"description":{"$ref":"#/components/schemas/ActionDescription"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","default":[]},"input_params":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Input Params"},"output_params":{"items":{"$ref":"#/components/schemas/ToolOutputParameterSchema"},"type":"array","title":"Output Params"},"api_tool_info":{"anyOf":[{"$ref":"#/components/schemas/ApiToolInfo"},{"type":"null"}]}},"type":"object","required":["action_id","provider_id","name","description","input_params","output_params","api_tool_info"],"title":"ActionSchema"},"ActionDescription":{"properties":{"human":{"type":"string","title":"Human","description":"The description shown to the user"},"llm":{"type":"string","maxLength":2048,"title":"Llm","description":"The description shown to the LLM"}},"type":"object","required":["human","llm"],"title":"ActionDescription"},"AvailableConnection":{"properties":{"connection_type_id":{"type":"string","title":"Connection Type Id"},"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"labels":{"items":{"type":"string"},"type":"array","title":"Labels"},"params":{"items":{"$ref":"#/components/schemas/ConnectionParameter"},"type":"array","title":"Params"},"minimum_plan":{"type":"string","title":"Minimum Plan"},"color":{"type":"string","title":"Color","default":"#A3A3A3"},"is_marketing_stunt":{"type":"boolean","title":"Is Marketing Stunt","default":false},"connection_type":{"$ref":"#/components/schemas/ConnectionType","default":"credentials"}},"type":"object","required":["connection_type_id","provider_id","name","description","labels","params","minimum_plan"],"title":"AvailableConnection"},"ConnectionParameter":{"properties":{"label":{"type":"string","title":"Label"},"type":{"$ref":"#/components/schemas/ToolParameterType","default":"string"},"placeholder":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Placeholder"},"default":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Default"},"help":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Help"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"required":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Required","default":true},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["label"],"title":"ConnectionParameter"},"ToolParameterType":{"type":"string","enum":["string","number","integer","float","boolean","select","secret","secret_multiline","file","files","knowledge_base","connection","textarea","multiple_select","string_array","number_array","date","datetime","object","object_array","dict","dict_array","code"],"title":"ToolParameterType"},"ConnectionType":{"type":"string","enum":["oauth","oauth_custom_credentials","credentials","ntlm","sqs"],"title":"ConnectionType"},"DeprecationInfo":{"properties":{"date_will_be_removed":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date Will Be Removed"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"}},"type":"object","title":"DeprecationInfo"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/tools/custom/{provider_id}":{"put":{"tags":["tools","custom-tools"],"summary":"Update Custom Tool","description":"Update an existing custom tool provider.\n\nArgs:\n    provider_id: Provider ID to update\n    data: Provider update data\n    service: Custom tool service instance\n    user_org: Current user's organization\n    user: Current user profile\n\nReturns:\n    Updated custom tool provider","operationId":"update_custom_tool_tools_custom__provider_id__put","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateToolProviderSchema"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolProviderSchema"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Delete Custom Tool

> Delete a custom tool provider.\
> \
> Args:\
>     provider\_id: Provider ID to delete\
>     user\_org: Current user's organization\
>     service: Custom tool service instance\
> \
> Returns:\
>     None

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"security":[{"OAuth2PasswordBearer":[]}],"components":{"securitySchemes":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"token"}}}},"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/tools/custom/{provider_id}":{"delete":{"tags":["tools","custom-tools"],"summary":"Delete Custom Tool","description":"Delete a custom tool provider.\n\nArgs:\n    provider_id: Provider ID to delete\n    user_org: Current user's organization\n    service: Custom tool service instance\n\nReturns:\n    None","operationId":"delete_custom_tool_tools_custom__provider_id__delete","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## GET /tools/stackai

> Get Stackai Tools

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"paths":{"/tools/stackai":{"get":{"tags":["tools","stackai-tools"],"summary":"Get Stackai Tools","operationId":"get_stackai_tools_tools_stackai_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ToolProviderSchema"},"type":"array","title":"Response Get Stackai Tools Tools Stackai Get"}}}}}}}},"components":{"schemas":{"ToolProviderSchema":{"properties":{"provider_id":{"type":"string","title":"Provider Id"},"provider_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Version"},"provider_group":{"anyOf":[{"items":{"$ref":"#/components/schemas/ProviderGroupEnum"},"type":"array"},{"type":"null"}],"title":"Provider Group"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"icon":{"type":"string","title":"Icon"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"color":{"type":"string","title":"Color","default":"#A3A3A3"},"triggers":{"items":{"$ref":"#/components/schemas/TriggerSchema"},"type":"array","title":"Triggers"},"actions":{"items":{"$ref":"#/components/schemas/ActionSchema"},"type":"array","title":"Actions"},"connections":{"anyOf":[{"items":{"$ref":"#/components/schemas/AvailableConnection"},"type":"array"},{"type":"null"}],"title":"Connections"},"deprecation_info":{"anyOf":[{"$ref":"#/components/schemas/DeprecationInfo"},{"type":"null"}]},"openapi_schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Openapi Schema"},"headers":{"anyOf":[{"items":{"$ref":"#/components/schemas/HeaderSchema"},"type":"array"},{"type":"null"}],"title":"Headers"}},"type":"object","required":["provider_id","provider_version","provider_group","name","description","icon","tags","triggers","actions","connections","openapi_schema","headers"],"title":"ToolProviderSchema"},"ProviderGroupEnum":{"type":"string","enum":["LLM","SCRAPER","BY_STACK_AI","APPS","DATABASE"],"title":"ProviderGroupEnum"},"TriggerSchema":{"properties":{"trigger_id":{"type":"string","title":"Trigger Id"},"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"},"input_params":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Input Params"},"output_params":{"items":{"$ref":"#/components/schemas/ToolOutputParameterSchema"},"type":"array","title":"Output Params"},"api_tool_info":{"anyOf":[{"$ref":"#/components/schemas/ApiToolInfo"},{"type":"null"}]}},"type":"object","required":["trigger_id","provider_id","name","description","input_params","output_params","api_tool_info"],"title":"TriggerSchema"},"ToolInputParameterSchema":{"properties":{"label":{"type":"string","title":"Label"},"type":{"type":"string","title":"Type"},"form":{"type":"string","title":"Form"},"required":{"type":"boolean","title":"Required"},"llm_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Description"},"human_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Human Description"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"placeholder":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Placeholder"},"min":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Min"},"max":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Max"},"options":{"items":{},"type":"array","title":"Options","default":[]},"default":{"anyOf":[{},{"type":"null"}],"title":"Default"},"has_dynamic_options":{"type":"boolean","title":"Has Dynamic Options","default":false},"depends_on":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Depends On"}},"type":"object","required":["label","type","form","required","llm_description","human_description","name","placeholder","min","max"],"title":"ToolInputParameterSchema"},"ToolOutputParameterSchema":{"properties":{"label":{"type":"string","title":"Label"},"type":{"type":"string","title":"Type"},"llm_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Description"},"human_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Human Description"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["label","type","llm_description","human_description","name"],"title":"ToolOutputParameterSchema"},"ApiToolInfo":{"properties":{"id":{"type":"string","title":"Id"},"server_url_with_path":{"type":"string","title":"Server Url With Path"},"method":{"type":"string","title":"Method"},"path":{"type":"string","title":"Path"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"parameters":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Parameters","default":[]},"headers":{"items":{"$ref":"#/components/schemas/HeaderSchema"},"type":"array","title":"Headers","default":[]}},"type":"object","required":["id","server_url_with_path","method","path"],"title":"ApiToolInfo","description":"Class for storing API tool schema information.\n\nStores metadata about an API-based tool including:\n- Server URL\n- Operation ID\n- HTTP method\n- Summary\n- Parameters\n- OpenAPI operation details"},"HeaderSchema":{"properties":{"order":{"type":"integer","title":"Order"},"key":{"type":"string","title":"Key"},"value":{"type":"string","title":"Value"}},"type":"object","required":["order","key","value"],"title":"HeaderSchema"},"ActionSchema":{"properties":{"action_id":{"type":"string","title":"Action Id"},"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"description":{"$ref":"#/components/schemas/ActionDescription"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","default":[]},"input_params":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Input Params"},"output_params":{"items":{"$ref":"#/components/schemas/ToolOutputParameterSchema"},"type":"array","title":"Output Params"},"api_tool_info":{"anyOf":[{"$ref":"#/components/schemas/ApiToolInfo"},{"type":"null"}]}},"type":"object","required":["action_id","provider_id","name","description","input_params","output_params","api_tool_info"],"title":"ActionSchema"},"ActionDescription":{"properties":{"human":{"type":"string","title":"Human","description":"The description shown to the user"},"llm":{"type":"string","maxLength":2048,"title":"Llm","description":"The description shown to the LLM"}},"type":"object","required":["human","llm"],"title":"ActionDescription"},"AvailableConnection":{"properties":{"connection_type_id":{"type":"string","title":"Connection Type Id"},"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"labels":{"items":{"type":"string"},"type":"array","title":"Labels"},"params":{"items":{"$ref":"#/components/schemas/ConnectionParameter"},"type":"array","title":"Params"},"minimum_plan":{"type":"string","title":"Minimum Plan"},"color":{"type":"string","title":"Color","default":"#A3A3A3"},"is_marketing_stunt":{"type":"boolean","title":"Is Marketing Stunt","default":false},"connection_type":{"$ref":"#/components/schemas/ConnectionType","default":"credentials"}},"type":"object","required":["connection_type_id","provider_id","name","description","labels","params","minimum_plan"],"title":"AvailableConnection"},"ConnectionParameter":{"properties":{"label":{"type":"string","title":"Label"},"type":{"$ref":"#/components/schemas/ToolParameterType","default":"string"},"placeholder":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Placeholder"},"default":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Default"},"help":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Help"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"required":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Required","default":true},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["label"],"title":"ConnectionParameter"},"ToolParameterType":{"type":"string","enum":["string","number","integer","float","boolean","select","secret","secret_multiline","file","files","knowledge_base","connection","textarea","multiple_select","string_array","number_array","date","datetime","object","object_array","dict","dict_array","code"],"title":"ToolParameterType"},"ConnectionType":{"type":"string","enum":["oauth","oauth_custom_credentials","credentials","ntlm","sqs"],"title":"ConnectionType"},"DeprecationInfo":{"properties":{"date_will_be_removed":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date Will Be Removed"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"}},"type":"object","title":"DeprecationInfo"}}}}
```

## Get Stackai Actions

> Get all providers with tools created by StackAI's team.

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"paths":{"/tools/stackai/actions":{"get":{"tags":["tools","stackai-tools"],"summary":"Get Stackai Actions","description":"Get all providers with tools created by StackAI's team.","operationId":"get_stackai_actions_tools_stackai_actions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"object"},"type":"array","title":"Response Get Stackai Actions Tools Stackai Actions Get"}}}}}}}}}
```

## Get Stackai Triggers

> Get all providers with tools created by StackAI's team.

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"paths":{"/tools/stackai/triggers":{"get":{"tags":["tools","stackai-tools"],"summary":"Get Stackai Triggers","description":"Get all providers with tools created by StackAI's team.","operationId":"get_stackai_triggers_tools_stackai_triggers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"object"},"type":"array","title":"Response Get Stackai Triggers Tools Stackai Triggers Get"}}}}}}}}}
```

## Get Stackai Providers

> Get all providers with tools created by StackAI's team.\
> \
> Args:\
>     minimal: Whether to return minimal schema or not\
> \
> Returns:\
>     List of providers with tools created by StackAI's team

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"paths":{"/tools/stackai/providers":{"get":{"tags":["tools","stackai-tools"],"summary":"Get Stackai Providers","description":"Get all providers with tools created by StackAI's team.\n\nArgs:\n    minimal: Whether to return minimal schema or not\n\nReturns:\n    List of providers with tools created by StackAI's team","operationId":"get_stackai_providers_tools_stackai_providers_get","parameters":[{"name":"minimal","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Minimal"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/ToolProviderMinimalSchema"},{"$ref":"#/components/schemas/ToolProviderSchema"}]},"title":"Response Get Stackai Providers Tools Stackai Providers Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"ToolProviderMinimalSchema":{"properties":{"provider_id":{"type":"string","title":"Provider Id"},"provider_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Version"},"provider_group":{"anyOf":[{"items":{"$ref":"#/components/schemas/ProviderGroupEnum"},"type":"array"},{"type":"null"}],"title":"Provider Group"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"icon":{"type":"string","title":"Icon"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"labels":{"items":{"type":"string"},"type":"array","title":"Labels"},"color":{"type":"string","title":"Color","default":"#A3A3A3"},"triggers":{"type":"integer","title":"Triggers"},"actions":{"type":"integer","title":"Actions"},"deprecation_info":{"anyOf":[{"$ref":"#/components/schemas/DeprecationInfo"},{"type":"null"}]},"openapi_schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Openapi Schema"},"headers":{"anyOf":[{"items":{"$ref":"#/components/schemas/HeaderSchema"},"type":"array"},{"type":"null"}],"title":"Headers"}},"type":"object","required":["provider_id","provider_version","provider_group","name","description","icon","tags","labels","triggers","actions","openapi_schema","headers"],"title":"ToolProviderMinimalSchema"},"ProviderGroupEnum":{"type":"string","enum":["LLM","SCRAPER","BY_STACK_AI","APPS","DATABASE"],"title":"ProviderGroupEnum"},"DeprecationInfo":{"properties":{"date_will_be_removed":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date Will Be Removed"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"}},"type":"object","title":"DeprecationInfo"},"HeaderSchema":{"properties":{"order":{"type":"integer","title":"Order"},"key":{"type":"string","title":"Key"},"value":{"type":"string","title":"Value"}},"type":"object","required":["order","key","value"],"title":"HeaderSchema"},"ToolProviderSchema":{"properties":{"provider_id":{"type":"string","title":"Provider Id"},"provider_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Version"},"provider_group":{"anyOf":[{"items":{"$ref":"#/components/schemas/ProviderGroupEnum"},"type":"array"},{"type":"null"}],"title":"Provider Group"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"icon":{"type":"string","title":"Icon"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"color":{"type":"string","title":"Color","default":"#A3A3A3"},"triggers":{"items":{"$ref":"#/components/schemas/TriggerSchema"},"type":"array","title":"Triggers"},"actions":{"items":{"$ref":"#/components/schemas/ActionSchema"},"type":"array","title":"Actions"},"connections":{"anyOf":[{"items":{"$ref":"#/components/schemas/AvailableConnection"},"type":"array"},{"type":"null"}],"title":"Connections"},"deprecation_info":{"anyOf":[{"$ref":"#/components/schemas/DeprecationInfo"},{"type":"null"}]},"openapi_schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Openapi Schema"},"headers":{"anyOf":[{"items":{"$ref":"#/components/schemas/HeaderSchema"},"type":"array"},{"type":"null"}],"title":"Headers"}},"type":"object","required":["provider_id","provider_version","provider_group","name","description","icon","tags","triggers","actions","connections","openapi_schema","headers"],"title":"ToolProviderSchema"},"TriggerSchema":{"properties":{"trigger_id":{"type":"string","title":"Trigger Id"},"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"},"input_params":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Input Params"},"output_params":{"items":{"$ref":"#/components/schemas/ToolOutputParameterSchema"},"type":"array","title":"Output Params"},"api_tool_info":{"anyOf":[{"$ref":"#/components/schemas/ApiToolInfo"},{"type":"null"}]}},"type":"object","required":["trigger_id","provider_id","name","description","input_params","output_params","api_tool_info"],"title":"TriggerSchema"},"ToolInputParameterSchema":{"properties":{"label":{"type":"string","title":"Label"},"type":{"type":"string","title":"Type"},"form":{"type":"string","title":"Form"},"required":{"type":"boolean","title":"Required"},"llm_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Description"},"human_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Human Description"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"placeholder":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Placeholder"},"min":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Min"},"max":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Max"},"options":{"items":{},"type":"array","title":"Options","default":[]},"default":{"anyOf":[{},{"type":"null"}],"title":"Default"},"has_dynamic_options":{"type":"boolean","title":"Has Dynamic Options","default":false},"depends_on":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Depends On"}},"type":"object","required":["label","type","form","required","llm_description","human_description","name","placeholder","min","max"],"title":"ToolInputParameterSchema"},"ToolOutputParameterSchema":{"properties":{"label":{"type":"string","title":"Label"},"type":{"type":"string","title":"Type"},"llm_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Description"},"human_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Human Description"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["label","type","llm_description","human_description","name"],"title":"ToolOutputParameterSchema"},"ApiToolInfo":{"properties":{"id":{"type":"string","title":"Id"},"server_url_with_path":{"type":"string","title":"Server Url With Path"},"method":{"type":"string","title":"Method"},"path":{"type":"string","title":"Path"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"parameters":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Parameters","default":[]},"headers":{"items":{"$ref":"#/components/schemas/HeaderSchema"},"type":"array","title":"Headers","default":[]}},"type":"object","required":["id","server_url_with_path","method","path"],"title":"ApiToolInfo","description":"Class for storing API tool schema information.\n\nStores metadata about an API-based tool including:\n- Server URL\n- Operation ID\n- HTTP method\n- Summary\n- Parameters\n- OpenAPI operation details"},"ActionSchema":{"properties":{"action_id":{"type":"string","title":"Action Id"},"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"description":{"$ref":"#/components/schemas/ActionDescription"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","default":[]},"input_params":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Input Params"},"output_params":{"items":{"$ref":"#/components/schemas/ToolOutputParameterSchema"},"type":"array","title":"Output Params"},"api_tool_info":{"anyOf":[{"$ref":"#/components/schemas/ApiToolInfo"},{"type":"null"}]}},"type":"object","required":["action_id","provider_id","name","description","input_params","output_params","api_tool_info"],"title":"ActionSchema"},"ActionDescription":{"properties":{"human":{"type":"string","title":"Human","description":"The description shown to the user"},"llm":{"type":"string","maxLength":2048,"title":"Llm","description":"The description shown to the LLM"}},"type":"object","required":["human","llm"],"title":"ActionDescription"},"AvailableConnection":{"properties":{"connection_type_id":{"type":"string","title":"Connection Type Id"},"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"labels":{"items":{"type":"string"},"type":"array","title":"Labels"},"params":{"items":{"$ref":"#/components/schemas/ConnectionParameter"},"type":"array","title":"Params"},"minimum_plan":{"type":"string","title":"Minimum Plan"},"color":{"type":"string","title":"Color","default":"#A3A3A3"},"is_marketing_stunt":{"type":"boolean","title":"Is Marketing Stunt","default":false},"connection_type":{"$ref":"#/components/schemas/ConnectionType","default":"credentials"}},"type":"object","required":["connection_type_id","provider_id","name","description","labels","params","minimum_plan"],"title":"AvailableConnection"},"ConnectionParameter":{"properties":{"label":{"type":"string","title":"Label"},"type":{"$ref":"#/components/schemas/ToolParameterType","default":"string"},"placeholder":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Placeholder"},"default":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Default"},"help":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Help"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"required":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Required","default":true},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["label"],"title":"ConnectionParameter"},"ToolParameterType":{"type":"string","enum":["string","number","integer","float","boolean","select","secret","secret_multiline","file","files","knowledge_base","connection","textarea","multiple_select","string_array","number_array","date","datetime","object","object_array","dict","dict_array","code"],"title":"ToolParameterType"},"ConnectionType":{"type":"string","enum":["oauth","oauth_custom_credentials","credentials","ntlm","sqs"],"title":"ConnectionType"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
```

## GET /tools/stackai/providers/{provider\_id}

> Get Stackai Provider

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"paths":{"/tools/stackai/providers/{provider_id}":{"get":{"tags":["tools","stackai-tools"],"summary":"Get Stackai Provider","operationId":"get_stackai_provider_tools_stackai_providers__provider_id__get","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolProviderSchema"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"ToolProviderSchema":{"properties":{"provider_id":{"type":"string","title":"Provider Id"},"provider_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Version"},"provider_group":{"anyOf":[{"items":{"$ref":"#/components/schemas/ProviderGroupEnum"},"type":"array"},{"type":"null"}],"title":"Provider Group"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"icon":{"type":"string","title":"Icon"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"color":{"type":"string","title":"Color","default":"#A3A3A3"},"triggers":{"items":{"$ref":"#/components/schemas/TriggerSchema"},"type":"array","title":"Triggers"},"actions":{"items":{"$ref":"#/components/schemas/ActionSchema"},"type":"array","title":"Actions"},"connections":{"anyOf":[{"items":{"$ref":"#/components/schemas/AvailableConnection"},"type":"array"},{"type":"null"}],"title":"Connections"},"deprecation_info":{"anyOf":[{"$ref":"#/components/schemas/DeprecationInfo"},{"type":"null"}]},"openapi_schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Openapi Schema"},"headers":{"anyOf":[{"items":{"$ref":"#/components/schemas/HeaderSchema"},"type":"array"},{"type":"null"}],"title":"Headers"}},"type":"object","required":["provider_id","provider_version","provider_group","name","description","icon","tags","triggers","actions","connections","openapi_schema","headers"],"title":"ToolProviderSchema"},"ProviderGroupEnum":{"type":"string","enum":["LLM","SCRAPER","BY_STACK_AI","APPS","DATABASE"],"title":"ProviderGroupEnum"},"TriggerSchema":{"properties":{"trigger_id":{"type":"string","title":"Trigger Id"},"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"},"input_params":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Input Params"},"output_params":{"items":{"$ref":"#/components/schemas/ToolOutputParameterSchema"},"type":"array","title":"Output Params"},"api_tool_info":{"anyOf":[{"$ref":"#/components/schemas/ApiToolInfo"},{"type":"null"}]}},"type":"object","required":["trigger_id","provider_id","name","description","input_params","output_params","api_tool_info"],"title":"TriggerSchema"},"ToolInputParameterSchema":{"properties":{"label":{"type":"string","title":"Label"},"type":{"type":"string","title":"Type"},"form":{"type":"string","title":"Form"},"required":{"type":"boolean","title":"Required"},"llm_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Description"},"human_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Human Description"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"placeholder":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Placeholder"},"min":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Min"},"max":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Max"},"options":{"items":{},"type":"array","title":"Options","default":[]},"default":{"anyOf":[{},{"type":"null"}],"title":"Default"},"has_dynamic_options":{"type":"boolean","title":"Has Dynamic Options","default":false},"depends_on":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Depends On"}},"type":"object","required":["label","type","form","required","llm_description","human_description","name","placeholder","min","max"],"title":"ToolInputParameterSchema"},"ToolOutputParameterSchema":{"properties":{"label":{"type":"string","title":"Label"},"type":{"type":"string","title":"Type"},"llm_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Description"},"human_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Human Description"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["label","type","llm_description","human_description","name"],"title":"ToolOutputParameterSchema"},"ApiToolInfo":{"properties":{"id":{"type":"string","title":"Id"},"server_url_with_path":{"type":"string","title":"Server Url With Path"},"method":{"type":"string","title":"Method"},"path":{"type":"string","title":"Path"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"parameters":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Parameters","default":[]},"headers":{"items":{"$ref":"#/components/schemas/HeaderSchema"},"type":"array","title":"Headers","default":[]}},"type":"object","required":["id","server_url_with_path","method","path"],"title":"ApiToolInfo","description":"Class for storing API tool schema information.\n\nStores metadata about an API-based tool including:\n- Server URL\n- Operation ID\n- HTTP method\n- Summary\n- Parameters\n- OpenAPI operation details"},"HeaderSchema":{"properties":{"order":{"type":"integer","title":"Order"},"key":{"type":"string","title":"Key"},"value":{"type":"string","title":"Value"}},"type":"object","required":["order","key","value"],"title":"HeaderSchema"},"ActionSchema":{"properties":{"action_id":{"type":"string","title":"Action Id"},"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"description":{"$ref":"#/components/schemas/ActionDescription"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","default":[]},"input_params":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Input Params"},"output_params":{"items":{"$ref":"#/components/schemas/ToolOutputParameterSchema"},"type":"array","title":"Output Params"},"api_tool_info":{"anyOf":[{"$ref":"#/components/schemas/ApiToolInfo"},{"type":"null"}]}},"type":"object","required":["action_id","provider_id","name","description","input_params","output_params","api_tool_info"],"title":"ActionSchema"},"ActionDescription":{"properties":{"human":{"type":"string","title":"Human","description":"The description shown to the user"},"llm":{"type":"string","maxLength":2048,"title":"Llm","description":"The description shown to the LLM"}},"type":"object","required":["human","llm"],"title":"ActionDescription"},"AvailableConnection":{"properties":{"connection_type_id":{"type":"string","title":"Connection Type Id"},"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"labels":{"items":{"type":"string"},"type":"array","title":"Labels"},"params":{"items":{"$ref":"#/components/schemas/ConnectionParameter"},"type":"array","title":"Params"},"minimum_plan":{"type":"string","title":"Minimum Plan"},"color":{"type":"string","title":"Color","default":"#A3A3A3"},"is_marketing_stunt":{"type":"boolean","title":"Is Marketing Stunt","default":false},"connection_type":{"$ref":"#/components/schemas/ConnectionType","default":"credentials"}},"type":"object","required":["connection_type_id","provider_id","name","description","labels","params","minimum_plan"],"title":"AvailableConnection"},"ConnectionParameter":{"properties":{"label":{"type":"string","title":"Label"},"type":{"$ref":"#/components/schemas/ToolParameterType","default":"string"},"placeholder":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Placeholder"},"default":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Default"},"help":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Help"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"required":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Required","default":true},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["label"],"title":"ConnectionParameter"},"ToolParameterType":{"type":"string","enum":["string","number","integer","float","boolean","select","secret","secret_multiline","file","files","knowledge_base","connection","textarea","multiple_select","string_array","number_array","date","datetime","object","object_array","dict","dict_array","code"],"title":"ToolParameterType"},"ConnectionType":{"type":"string","enum":["oauth","oauth_custom_credentials","credentials","ntlm","sqs"],"title":"ConnectionType"},"DeprecationInfo":{"properties":{"date_will_be_removed":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date Will Be Removed"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"}},"type":"object","title":"DeprecationInfo"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
```

## Get Integrations

> Get all integration IDs available, with trigger and action IDs.\
> \
> Used to generate integrations documentation without fetching all the data, which is very heavy.

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"paths":{"/tools/stackai/integrations":{"get":{"tags":["tools","stackai-tools"],"summary":"Get Integrations","description":"Get all integration IDs available, with trigger and action IDs.\n\nUsed to generate integrations documentation without fetching all the data, which is very heavy.","operationId":"get_integrations_tools_stackai_integrations_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/IntegrationSchema"},"type":"array","title":"Response Get Integrations Tools Stackai Integrations Get"}}}}}}}},"components":{"schemas":{"IntegrationSchema":{"properties":{"provider_id":{"type":"string","title":"Provider Id"},"triggers":{"items":{"type":"string"},"type":"array","title":"Triggers"},"actions":{"items":{"type":"string"},"type":"array","title":"Actions"}},"type":"object","required":["provider_id","triggers","actions"],"title":"IntegrationSchema"}}}}
```

## Get Action By Provider And Id

> Get the data for a specific native action available and implemented by StackAI.

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"paths":{"/tools/stackai/providers/{provider_id}/actions/{action_id}":{"get":{"tags":["tools","stackai-tools"],"summary":"Get Action By Provider And Id","description":"Get the data for a specific native action available and implemented by StackAI.","operationId":"get_action_by_provider_and_id_tools_stackai_providers__provider_id__actions__action_id__get","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}},{"name":"action_id","in":"path","required":true,"schema":{"type":"string","title":"Action Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionSchema"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"ActionSchema":{"properties":{"action_id":{"type":"string","title":"Action Id"},"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"description":{"$ref":"#/components/schemas/ActionDescription"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","default":[]},"input_params":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Input Params"},"output_params":{"items":{"$ref":"#/components/schemas/ToolOutputParameterSchema"},"type":"array","title":"Output Params"},"api_tool_info":{"anyOf":[{"$ref":"#/components/schemas/ApiToolInfo"},{"type":"null"}]}},"type":"object","required":["action_id","provider_id","name","description","input_params","output_params","api_tool_info"],"title":"ActionSchema"},"ActionDescription":{"properties":{"human":{"type":"string","title":"Human","description":"The description shown to the user"},"llm":{"type":"string","maxLength":2048,"title":"Llm","description":"The description shown to the LLM"}},"type":"object","required":["human","llm"],"title":"ActionDescription"},"ToolInputParameterSchema":{"properties":{"label":{"type":"string","title":"Label"},"type":{"type":"string","title":"Type"},"form":{"type":"string","title":"Form"},"required":{"type":"boolean","title":"Required"},"llm_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Description"},"human_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Human Description"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"placeholder":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Placeholder"},"min":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Min"},"max":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Max"},"options":{"items":{},"type":"array","title":"Options","default":[]},"default":{"anyOf":[{},{"type":"null"}],"title":"Default"},"has_dynamic_options":{"type":"boolean","title":"Has Dynamic Options","default":false},"depends_on":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Depends On"}},"type":"object","required":["label","type","form","required","llm_description","human_description","name","placeholder","min","max"],"title":"ToolInputParameterSchema"},"ToolOutputParameterSchema":{"properties":{"label":{"type":"string","title":"Label"},"type":{"type":"string","title":"Type"},"llm_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Description"},"human_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Human Description"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["label","type","llm_description","human_description","name"],"title":"ToolOutputParameterSchema"},"ApiToolInfo":{"properties":{"id":{"type":"string","title":"Id"},"server_url_with_path":{"type":"string","title":"Server Url With Path"},"method":{"type":"string","title":"Method"},"path":{"type":"string","title":"Path"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"parameters":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Parameters","default":[]},"headers":{"items":{"$ref":"#/components/schemas/HeaderSchema"},"type":"array","title":"Headers","default":[]}},"type":"object","required":["id","server_url_with_path","method","path"],"title":"ApiToolInfo","description":"Class for storing API tool schema information.\n\nStores metadata about an API-based tool including:\n- Server URL\n- Operation ID\n- HTTP method\n- Summary\n- Parameters\n- OpenAPI operation details"},"HeaderSchema":{"properties":{"order":{"type":"integer","title":"Order"},"key":{"type":"string","title":"Key"},"value":{"type":"string","title":"Value"}},"type":"object","required":["order","key","value"],"title":"HeaderSchema"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
```

## Get Trigger By Provider And Id

> Get the data for a specific native trigger available and implemented by StackAI.

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"paths":{"/tools/stackai/providers/{provider_id}/triggers/{trigger_id}":{"get":{"tags":["tools","stackai-tools"],"summary":"Get Trigger By Provider And Id","description":"Get the data for a specific native trigger available and implemented by StackAI.","operationId":"get_trigger_by_provider_and_id_tools_stackai_providers__provider_id__triggers__trigger_id__get","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}},{"name":"trigger_id","in":"path","required":true,"schema":{"type":"string","title":"Trigger Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TriggerSchema"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"TriggerSchema":{"properties":{"trigger_id":{"type":"string","title":"Trigger Id"},"provider_id":{"type":"string","title":"Provider Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"},"input_params":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Input Params"},"output_params":{"items":{"$ref":"#/components/schemas/ToolOutputParameterSchema"},"type":"array","title":"Output Params"},"api_tool_info":{"anyOf":[{"$ref":"#/components/schemas/ApiToolInfo"},{"type":"null"}]}},"type":"object","required":["trigger_id","provider_id","name","description","input_params","output_params","api_tool_info"],"title":"TriggerSchema"},"ToolInputParameterSchema":{"properties":{"label":{"type":"string","title":"Label"},"type":{"type":"string","title":"Type"},"form":{"type":"string","title":"Form"},"required":{"type":"boolean","title":"Required"},"llm_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Description"},"human_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Human Description"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"placeholder":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Placeholder"},"min":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Min"},"max":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Max"},"options":{"items":{},"type":"array","title":"Options","default":[]},"default":{"anyOf":[{},{"type":"null"}],"title":"Default"},"has_dynamic_options":{"type":"boolean","title":"Has Dynamic Options","default":false},"depends_on":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Depends On"}},"type":"object","required":["label","type","form","required","llm_description","human_description","name","placeholder","min","max"],"title":"ToolInputParameterSchema"},"ToolOutputParameterSchema":{"properties":{"label":{"type":"string","title":"Label"},"type":{"type":"string","title":"Type"},"llm_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Description"},"human_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Human Description"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["label","type","llm_description","human_description","name"],"title":"ToolOutputParameterSchema"},"ApiToolInfo":{"properties":{"id":{"type":"string","title":"Id"},"server_url_with_path":{"type":"string","title":"Server Url With Path"},"method":{"type":"string","title":"Method"},"path":{"type":"string","title":"Path"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"parameters":{"items":{"$ref":"#/components/schemas/ToolInputParameterSchema"},"type":"array","title":"Parameters","default":[]},"headers":{"items":{"$ref":"#/components/schemas/HeaderSchema"},"type":"array","title":"Headers","default":[]}},"type":"object","required":["id","server_url_with_path","method","path"],"title":"ApiToolInfo","description":"Class for storing API tool schema information.\n\nStores metadata about an API-based tool including:\n- Server URL\n- Operation ID\n- HTTP method\n- Summary\n- Parameters\n- OpenAPI operation details"},"HeaderSchema":{"properties":{"order":{"type":"integer","title":"Order"},"key":{"type":"string","title":"Key"},"value":{"type":"string","title":"Value"}},"type":"object","required":["order","key","value"],"title":"HeaderSchema"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
```

## Run Action

> Run an action.

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"security":[{"OAuth2PasswordBearer":[]}],"components":{"securitySchemes":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"token"}}}},"schemas":{"RunActionRequest":{"properties":{"project_id":{"type":"string","title":"Project Id"},"inputs":{"additionalProperties":true,"type":"object","title":"Inputs"}},"type":"object","required":["project_id","inputs"],"title":"RunActionRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/tools/stackai/providers/{provider_id}/actions/{action_id}/run":{"post":{"tags":["tools","stackai-tools"],"summary":"Run Action","description":"Run an action.","operationId":"run_action_tools_stackai_providers__provider_id__actions__action_id__run_post","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}},{"name":"action_id","in":"path","required":true,"schema":{"type":"string","title":"Action Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunActionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Run Action Tools Stackai Providers  Provider Id  Actions  Action Id  Run Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Get Action Inputs

> Get the input parameters for an action as a JSON schema.

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"paths":{"/tools/stackai/providers/{provider_id}/actions/{action_id}/inputs":{"get":{"tags":["tools","stackai-tools"],"summary":"Get Action Inputs","description":"Get the input parameters for an action as a JSON schema.","operationId":"get_action_inputs_tools_stackai_providers__provider_id__actions__action_id__inputs_get","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}},{"name":"action_id","in":"path","required":true,"schema":{"type":"string","title":"Action Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Action Inputs Tools Stackai Providers  Provider Id  Actions  Action Id  Inputs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
```

## Get Action Outputs

> Get the output parameters for an action as a JSON schema.

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"paths":{"/tools/stackai/providers/{provider_id}/actions/{action_id}/outputs":{"get":{"tags":["tools","stackai-tools"],"summary":"Get Action Outputs","description":"Get the output parameters for an action as a JSON schema.","operationId":"get_action_outputs_tools_stackai_providers__provider_id__actions__action_id__outputs_get","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}},{"name":"action_id","in":"path","required":true,"schema":{"type":"string","title":"Action Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Action Outputs Tools Stackai Providers  Provider Id  Actions  Action Id  Outputs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
```

## Get Provider Icon

> Get the icon for a specific provider.

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"paths":{"/tools/stackai/providers/{provider_id}/icon":{"get":{"tags":["tools","stackai-tools"],"summary":"Get Provider Icon","description":"Get the icon for a specific provider.","operationId":"get_provider_icon_tools_stackai_providers__provider_id__icon_get","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
```

## Get Action Options

> Get action options for a specific action and provider.\
> \
> Args:\
>     options\_request: Action and provider identifiers\
>     user\_organization: The user organization\
> \
> Returns:\
>     List of schema strings for the action

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"security":[{"OAuth2PasswordBearer":[]}],"components":{"securitySchemes":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"token"}}}},"schemas":{"ToolOptionsRequest":{"properties":{"config_name":{"type":"string","title":"Config Name"},"parameters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Parameters"},"connection_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Connection Id"},"provider_id":{"type":"string","title":"Provider Id"},"action_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action Id"},"trigger_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trigger Id"}},"type":"object","required":["config_name","provider_id"],"title":"ToolOptionsRequest"},"ToolConfigOption":{"properties":{"value":{"type":"string","title":"Value"},"label":{"type":"string","title":"Label"}},"type":"object","required":["value","label"],"title":"ToolConfigOption"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/tools/options":{"post":{"tags":["tools"],"summary":"Get Action Options","description":"Get action options for a specific action and provider.\n\nArgs:\n    options_request: Action and provider identifiers\n    user_organization: The user organization\n\nReturns:\n    List of schema strings for the action","operationId":"get_action_options_tools_options_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolOptionsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ToolConfigOption"},"type":"array","title":"Response Get Action Options Tools Options Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```