How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

AppDirect Tools API

The Tools API from AppDirect — 24 operation(s) for tools.

AppDirect Tools API is one of 75 APIs that AppDirect publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Tools. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 34 operations across 24 paths, and defines 33 schemas. It is described by OpenAPI 3.2.0, at version v296.0-SNAPSHOT.

Requests are made against 2 base URLs: https://marketplace.appdirect.com/api, https://virtserver.swaggerhub.com.

34 operations 24 paths 33 schemas 3 DELETE12 GET10 POST9 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
v296.0-SNAPSHOT
Base URL
https://marketplace.appdirect.com/api
Resource Areas
1

Paths & Operations 34

Across 24 paths, the API surfaces 34 operations — 3 DELETE, 12 GET, 10 POST, 9 PUT. Each is listed below with its method, path, parameters, and response codes.

Tools 34
GET
/api/v1/ai/{aiId}/tools
List tools for the AI
listAITools 1 param → 200403404
POST
/api/v1/ai/{aiId}/tools
Create a tool for the AI
createAITool 1 param body → 201400403
GET
/api/v1/ai/{aiId}/tools/{toolId}
Get a tool for the AI
getAITool 2 params → 200403404
PUT
/api/v1/ai/{aiId}/tools/{toolId}
Update a tool for the AI
updateAITool 2 params body → 200400403
DELETE
/api/v1/ai/{aiId}/tools/{toolId}
Delete a tool
deleteAITool 2 params → 204403
GET
/api/v1/ai/{aiId}/tools/api-function
List API function tools for the AI
listApiFunctionTools 1 param → 200404
POST
/api/v1/ai/{aiId}/tools/api-function
Create an API function tool
createApiFunctionTool 1 param body → 201
PUT
/api/v1/ai/{aiId}/tools/{toolId}/api-function
Update an API function tool
updateApiFunctionTool 2 params body → 200
POST
/api/v1/ai/{aiId}/tools/sql
Create a SQL tool
createSqlTool 1 param body → 201
GET
/api/v1/ai/{aiId}/tools/python
List Python tools for the AI
listPythonTools 1 param → 200
POST
/api/v1/ai/{aiId}/tools/python
Create a Python tool
createPythonTool 1 param → 201
GET
/api/v1/ai/{aiId}/tools/user-input
List user input tools for the AI
listUserInputTools 1 param → 200
POST
/api/v1/ai/{aiId}/tools/user-input
Create a user input tool
createUserInputTool 1 param body → 201
GET
/api/v1/ai/{aiId}/tools/knowledge-retrieval
List knowledge retrieval tools for the AI
listKnowledgeRetrievalTools 1 param → 200
POST
/api/v1/ai/{aiId}/tools/knowledge-retrieval
Create a knowledge retrieval tool
createKnowledgeRetrievalTool 1 param body → 201
GET
/api/v1/ai/{aiId}/tools/image-generation
List image generation tools for the AI
listImageGenerationTools 1 param → 200
POST
/api/v1/ai/{aiId}/tools/image-generation
Create an image generation tool
createImageGenerationTool 1 param body → 201
GET
/api/v1/ai/{aiId}/tools/mcp
List MCP server tools for the AI
listMcpServerTools 1 param → 200
POST
/api/v1/ai/{aiId}/tools/mcp
Create an MCP server tool
createMcpServerTool 1 param body → 201
GET
/api/v1/ai/{aiId}/tools/auth
List tool OAuth status for the AI
listAIToolAuthStatus 1 param → 200
PUT
/api/v1/ai/{aiId}/tools/auth/reset
Reset tool OAuth tokens for the AI
resetAIToolAuth 1 param → 200
GET
/api/v1/tools/{toolId}
Get a tool
getTool 1 param → 200403404
DELETE
/api/v1/tools/{toolId}
Delete a tool
deleteTool 1 param → 204403
PUT
/api/v1/tools/{toolId}/sql
Update a SQL tool
updateSqlTool 1 param body → 200
PUT
/api/v1/tools/{toolId}/user-input
Update a user input tool
updateUserInputTool 1 param body → 200
PUT
/api/v1/tools/{toolId}/knowledge-retrieval
Update a knowledge retrieval tool
updateKnowledgeRetrievalTool 1 param body → 200
PUT
/api/v1/tools/{toolId}/image-generation
Update an image generation tool
updateImageGenerationTool 1 param body → 200
PUT
/api/v1/tools/{toolId}/mcp
Update an MCP server tool
updateMcpServerTool 1 param body → 200
PUT
/api/v1/tools/{toolId}/api-function
Update an API function tool
updateApiFunctionToolGlobal 1 param body → 200
GET
/api/v1/tools/{toolId}/api-function/callback
API function tool OAuth callback
apiFunctionToolCallback 2 params → 200
GET
/api/v1/tools/{toolId}/oauth-status
Get tool OAuth status
getToolOAuthStatus 1 param → 200
DELETE
/api/v1/tools/{toolId}/oauth-token
Delete a tool OAuth token
deleteToolOAuthToken 1 param → 204
POST
/api/v1/tools/{toolId}/oauth-initiate
Initiate tool OAuth flow
initiateToolOAuth 1 param → 200
POST
/api/v1/tools/mcp/preview
Preview MCP server tools
previewMcpServerTools body → 200

Schemas 33

The contract defines 33 schemas that model the data the API accepts and returns. The most detailed are Tool (11 properties), CreateKnowledgeRetrievalToolRequest (10 properties), CreateMcpServerToolRequest (8 properties), UpdateMcpServerToolRequest (7 properties). Each schema is shown below with its type and property counts.

UpdateUserInputToolRequest
object
5 properties 5 required
UpdateKnowledgeRetrievalToolRequest
Tool
object
11 properties
ToolAuthInfo
object
4 properties
SQLToolDatabaseType
string
CreateApiToolRequest
object
6 properties 4 required
UpdateMcpServerToolRequest
object
7 properties 1 required
PreviewMcpServerToolResponse
object
4 properties
ApiKeyAuthenticationData
object
3 properties
OAuthAuthenticationData
object
6 properties 5 required
CreateKnowledgeRetrievalToolRequest
object
10 properties 10 required
CreateSpreadsheetToolRequest
object
2 properties 2 required
UpdateImageGenerationToolRequest
ToolListResponse
object
1 property
OAuthTokenExchangeMethod
string
PreviewMcpServerToolRequest
object
6 properties
MCPTool
object
3 properties
AuthenticationType
string
UpdateApiToolRequest
CreateMcpServerToolRequest
object
8 properties 2 required
CreateImageGenerationToolRequest
object
6 properties 1 required
ApiKeyAuthType
string
ApiCompressionConfiguration
object
3 properties
CreateUserInputToolRequest
object
6 properties 6 required
CustomHeader
object
2 properties 2 required
CreateSQLToolRequest
object
7 properties 7 required
UpdateSQLToolRequest
object
6 properties 6 required
ToolOAuthStatus
object
2 properties
OAuthInitiateResponse
object
1 property 1 required
CreateWebSearchToolRequest
object
2 properties 1 required
UpdateWebSearchToolRequest
object
2 properties 1 required
ToolType
string
UpdateSpreadsheetToolRequest
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

appdirect-tools-api-openapi.yml Raw ↑

Other APIs AppDirect publishes across the network.

AppDirect AI Embed API
AppDirect AI Management API
AppDirect AI Models API
AppDirect AI User Inputs API
AppDirect Answer API
AppDirect API Keys API
AppDirect AppResellerAccount API
AppDirect AppResellerAssignment API
AppDirect AppResellerCatalog API
AppDirect AppResellerCompanyAssociation API
AppDirect AppResellerLeads API
AppDirect AppResellerOpportunities API
Where this information came from

This is an independent, third-party profile of AppDirect Tools API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.