Skip to main content
PATCH
/
v1
/
chat
/
tools
/
{id}
Update tool
curl --request PATCH \
  --url https://api.agntix.ai/v1/chat/tools/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "description": "Retrieves the current account balance and pending transactions.",
  "ajvPropertiesSchema": {
    "type": "object",
    "properties": {
      "customerId": {
        "type": "string"
      },
      "includeTransactions": {
        "type": "boolean",
        "default": false
      }
    },
    "required": [
      "customerId"
    ]
  }
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "GET_ACCOUNT_BALANCE",
  "description": "<string>",
  "ajvPropertiesSchema": {},
  "orgId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}
Every endpoint on this page requires either a Clerk-issued JWT (Authorization: Bearer <token>) or an organization API key (x-api-key: pk_…). Anonymous calls return 401 Unauthorized. See Authentication for the full setup.
Changes to a tool’s ajvPropertiesSchema or description are picked up on the next conversation turn — already-open sessions are not affected mid-conversation.

​
Code examples

curl -X PATCH https://api.agntix.ai/v1/chat/tools/550e8400-e29b-41d4-a716-446655440000 \
  -H "x-api-key: pk_live_••••" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Retrieves the current account balance and pending transactions. Call when user asks about their balance, available credit, or recent charges.",
    "ajvPropertiesSchema": {
      "type": "object",
      "properties": {
        "customerId": { "type": "string", "description": "Customer ID" },
        "includeTransactions": { "type": "boolean", "default": false, "description": "Include recent transactions" }
      },
      "required": ["customerId"]
    }
  }'

​
Sample response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "GET_ACCOUNT_BALANCE",
  "description": "Retrieves the current account balance and pending transactions.",
  "type": "API_TOOL",
  "orgId": "org_2abc123",
  "createdAt": "2026-04-29T10:00:00Z",
  "updatedAt": "2026-04-29T11:30:00Z"
}

Authorizations

​
x-api-key
string
header
required

Organization API key. Obtain from the dashboard. Format: pk_live_…

Path Parameters

​
id
string<uuid>
required

Body

application/json

All fields optional — only provided fields are updated.

​
name
string
​
description
string
​
apiTool
object
​
functionTool
object
​
ajvPropertiesSchema
object
​
preExecutionMessage
string

Response

Updated tool.

​
id
string<uuid>
​
name
string
Example:

"GET_ACCOUNT_BALANCE"

​
description
string
​
type
enum<string>
Available options:
API_TOOL,
FUNCTION_TOOL
​
ajvPropertiesSchema
object
​
orgId
string
​
createdAt
string<date-time>
​
updatedAt
string<date-time>