Skip to main content
GET
/
v1
/
chat
/
tools
/
{id}
Get tool
curl --request GET \
  --url https://api.agntix.ai/v1/chat/tools/{id} \
  --header 'x-api-key: <api-key>'
{
  "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.

​
Code examples

curl https://api.agntix.ai/v1/chat/tools/550e8400-e29b-41d4-a716-446655440000 \
  -H "x-api-key: pk_live_••••"

​
Sample response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "GET_ACCOUNT_BALANCE",
  "description": "Retrieves the current account balance for a customer.",
  "type": "API_TOOL",
  "ajvPropertiesSchema": {
    "type": "object",
    "properties": {
      "customerId": {
        "type": "string",
        "description": "The customer ID from the session metadata."
      }
    },
    "required": ["customerId"]
  },
  "orgId": "org_2abc123",
  "createdAt": "2026-04-29T10:00:00Z",
  "updatedAt": "2026-04-29T10:00:00Z"
}

Authorizations

​
x-api-key
string
header
required

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

Path Parameters

​
id
string<uuid>
required

Response

Tool detail.

​
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>