Skip to main content
GET
/
ai
/
tools
/
{tool_id}
Get AI tool by ID
curl --request GET \
  --url https://api.wacht.dev/ai/tools/{tool_id} \
  --header 'Authorization: <api-key>'
{
  "id": "1234567890123456789",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z",
  "name": "Get User Info",
  "description": "Retrieves user information",
  "tool_type": "api",
  "deployment_id": "9876543210987654321",
  "configuration": {
    "type": "api",
    "endpoint": "https://api.example.com/users",
    "method": "GET",
    "authorization": {
      "authorize_as_user": true,
      "jwt_template_id": 123,
      "custom_headers": [
        {
          "name": "user_id",
          "field_type": "string",
          "required": true,
          "description": "User ID",
          "items_type": "string"
        }
      ]
    },
    "request_body_schema": [
      {
        "name": "user_id",
        "field_type": "string",
        "required": true,
        "description": "User ID",
        "items_type": "string"
      }
    ],
    "url_params_schema": [
      {
        "name": "user_id",
        "field_type": "string",
        "required": true,
        "description": "User ID",
        "items_type": "string"
      }
    ],
    "timeout_seconds": 30
  }
}

Authorizations

Authorization
string
header
required

API key authentication (format: Bearer {api_key})

Path Parameters

tool_id
string
required

AI Tool ID

Response

AI tool found

id
string
Example:

"1234567890123456789"

created_at
string<date-time>
Example:

"2024-01-15T10:30:00Z"

updated_at
string<date-time>
Example:

"2024-01-15T10:30:00Z"

name
string
Example:

"Get User Info"

description
string | null
Example:

"Retrieves user information"

tool_type
enum<string>

Type of AI tool

Available options:
api,
platform_event,
platform_function,
internal,
use_external_service
deployment_id
string
Example:

"9876543210987654321"

configuration
object