Tools

Live API testing

Paste a tq_live_… key from Settings → API Keys. Requests are sent through this docs server to /api/v1/… (no browser CORS). The key is kept in sessionStorage only.

Base URL: https://api.taliiq.com — set $TALIIQ_API_KEY to a key from Settings → API Keys in the dashboard.

List tools

GET/api/v1/tools/tools.list · scope: tools:read

Cursor-paginated tools owned by your organization.

curl -X GET 'https://api.taliiq.com/api/v1/tools/?limit=20&cursor=' \
  -H 'Authorization: Bearer $TALIIQ_API_KEY'

import requests

url = "https://api.taliiq.com/api/v1/tools/?limit=20&cursor="
headers = {
  "Authorization": "Bearer $TALIIQ_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.status_code)
print(response.json())

const response = await fetch("https://api.taliiq.com/api/v1/tools/?limit=20&cursor=", {
  method: "GET",
  headers: {
    "Authorization": "Bearer $TALIIQ_API_KEY"
},
});

console.log(await response.json());

Try it live

/api/proxy/v1/tools/?limit=20&cursor=

Create tool

POST/api/v1/tools/tools.create · scope: tools:write

curl -X POST 'https://api.taliiq.com/api/v1/tools/' \
  -H 'Authorization: Bearer $TALIIQ_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"lookup_order","description":"Fetch order status","category":"integration","type":"http","body_schema":{"type":"object","properties":{"order_id":{"type":"string"}}},"metadata":{"url":"https://api.example.com/orders"}}'

import requests

url = "https://api.taliiq.com/api/v1/tools/"
headers = {
  "Authorization": "Bearer $TALIIQ_API_KEY",
  "Content-Type": "application/json"
}
payload = {
  "name": "lookup_order",
  "description": "Fetch order status",
  "category": "integration",
  "type": "http",
  "body_schema": {
    "type": "object",
    "properties": {
      "order_id": {
        "type": "string"
      }
    }
  },
  "metadata": {
    "url": "https://api.example.com/orders"
  }
}

response = requests.post(url, headers=headers, json=payload)
print(response.status_code)
print(response.json())

const response = await fetch("https://api.taliiq.com/api/v1/tools/", {
  method: "POST",
  headers: {
    "Authorization": "Bearer $TALIIQ_API_KEY",
    "Content-Type": "application/json"
},
  body: JSON.stringify({"name":"lookup_order","description":"Fetch order status","category":"integration","type":"http","body_schema":{"type":"object","properties":{"order_id":{"type":"string"}}},"metadata":{"url":"https://api.example.com/orders"}}),
});

console.log(await response.json());

Try it live

/api/proxy/v1/tools/

Request body (JSON)

Get tool

GET/api/v1/tools/{tool_id}tools.get · scope: tools:read

curl -X GET 'https://api.taliiq.com/api/v1/tools/{tool_id}/' \
  -H 'Authorization: Bearer $TALIIQ_API_KEY'

import requests

url = "https://api.taliiq.com/api/v1/tools/{tool_id}/"
headers = {
  "Authorization": "Bearer $TALIIQ_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.status_code)
print(response.json())

const response = await fetch("https://api.taliiq.com/api/v1/tools/{tool_id}/", {
  method: "GET",
  headers: {
    "Authorization": "Bearer $TALIIQ_API_KEY"
},
});

console.log(await response.json());

Try it live

/api/proxy/v1/tools/{id}/

Path IDs (slash-separated UUIDs)

Update tool

PATCH/api/v1/tools/{tool_id}tools.update · scope: tools:write

curl -X PATCH 'https://api.taliiq.com/api/v1/tools/{tool_id}/' \
  -H 'Authorization: Bearer $TALIIQ_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"description":"Updated description","is_active":true}'

import requests

url = "https://api.taliiq.com/api/v1/tools/{tool_id}/"
headers = {
  "Authorization": "Bearer $TALIIQ_API_KEY",
  "Content-Type": "application/json"
}
payload = {
  "description": "Updated description",
  "is_active": true
}

response = requests.patch(url, headers=headers, json=payload)
print(response.status_code)
print(response.json())

const response = await fetch("https://api.taliiq.com/api/v1/tools/{tool_id}/", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer $TALIIQ_API_KEY",
    "Content-Type": "application/json"
},
  body: JSON.stringify({"description":"Updated description","is_active":true}),
});

console.log(await response.json());

Try it live

/api/proxy/v1/tools/{id}/

Path IDs (slash-separated UUIDs)

Request body (JSON)

Delete tool

DELETE/api/v1/tools/{tool_id}tools.delete · scope: tools:write

Detach from all agents first. Returns 409 resource_in_use if still linked.

curl -X DELETE 'https://api.taliiq.com/api/v1/tools/{tool_id}/' \
  -H 'Authorization: Bearer $TALIIQ_API_KEY'

import requests

url = "https://api.taliiq.com/api/v1/tools/{tool_id}/"
headers = {
  "Authorization": "Bearer $TALIIQ_API_KEY"
}

response = requests.delete(url, headers=headers)
print(response.status_code)
print(response.json())

const response = await fetch("https://api.taliiq.com/api/v1/tools/{tool_id}/", {
  method: "DELETE",
  headers: {
    "Authorization": "Bearer $TALIIQ_API_KEY"
},
});

console.log(await response.json());

Try it live

/api/proxy/v1/tools/{id}/

Path IDs (slash-separated UUIDs)

Live API testing

List tools

Create tool

Get tool

Update tool

Delete tool

On this page