Vantax AIDocs
GET

List Custom Tools

Returns the custom tools defined in your sub-account.

GEThttps://api.vantaxai.com/v1/custom-tools

Custom tools are returned newest-first. Once a tool is created you can attach it to any Agent, which lets that Agent invoke your `endpoint_url` during a call or chat. Use `limit` and `starting_after` to page through large collections.

Headers

  • Authorizationstringrequired

    Bearer authentication with your secret API key.

    example: Bearer vx_live_3fa9c2…

Query Parameters

  • sub_account_idstringrequired

    The sub-account to list custom tools for.

    example: sub_8a1f4c2e

  • limitintegeroptional

    Number of records to return (1–100). Defaults to 20.

    example: 20

  • starting_afterstringoptional

    Cursor for pagination — a tool id to start after.

    example: tool_7b2e91

Request

curl https://api.vantaxai.com/v1/custom-tools?sub_account_id=sub_8a1f4c2e \
  -H "Authorization: Bearer vx_live_3fa9c2..."

Response

{
  "success": true,
  "data": [
    {
      "id": "tool_7b2e91",
      "name": "check_order_status",
      "description": "Look up the current status of a customer order by order number.",
      "schema": {
        "type": "object",
        "properties": {
          "order_number": {
            "type": "string",
            "description": "The customer's order number, e.g. ORD-10482."
          },
          "email": {
            "type": "string",
            "description": "Email on file for verification."
          }
        },
        "required": ["order_number"]
      },
      "endpoint_url": "https://api.acme-store.com/orders/lookup",
      "http_method": "POST",
      "sub_account_id": "sub_8a1f4c2e",
      "created_at": "2026-01-14T10:30:00Z"
    }
  ],
  "pagination": {
    "total": 3,
    "limit": 20,
    "has_more": false
  }
}