Skip to main content
POST
/
api
/
v1
/
tools
Create a custom tool
curl --request POST \
  --url https://api.kataven.ai/v1/api/v1/tools \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "category": "ecommerce",
  "description": "Look up an order by its ID. Returns status, line items, shipping address, and tracking links if available.",
  "implementation_code": "def run(args, context):\n    return get_order(args['order_id'])",
  "implementation_config": {},
  "implementation_type": "http",
  "name": "lookup_order",
  "schema": {},
  "tags": [
    "orders",
    "ecommerce"
  ]
}
EOF
{}

Authorizations

​
Authorization
string
header
required

Headers

​
X-Account-ID
string

Tenant database. Required when using a Zitadel JWT.

Body

application/json

Tool spec

Tool spec

​
category
string
Example:

"ecommerce"

​
description
string
Example:

"Look up an order by its ID. Returns status, line items, shipping address, and tracking links if available."

​
implementation_code
string
Example:

"def run(args, context):\n return get_order(args['order_id'])"

​
implementation_config
object
​
implementation_type
enum<string>
Available options:
http,
python
Example:

"http"

​
name
string
Example:

"lookup_order"

​
schema
object
​
tags
string[]
Example:
["orders", "ecommerce"]

Response

Created

​
{key}
string