Tools reference
Every Intelligence tool, its REST path, and whether it bills.
Tools
| Tool | REST path | Billable |
|---|---|---|
| search_knowledge | POST /api/v1/intelligence/retrieve | Yes |
| match_runbook | POST /api/v1/intelligence/match-runbook | Yes |
| create_ticket | POST /api/v1/intelligence/create-ticket | Yes |
| remember_fact | POST /api/v1/intelligence/remember | Yes |
| get_visitor_memory | POST /api/v1/intelligence/memory | Yes |
| identify_visitor | POST /api/v1/intelligence/identify | No |
| check_escalation_signal | POST /api/v1/intelligence/escalation | No |
You can also POST /api/v1/intelligence with a tool field to invoke any catalog tool through one endpoint. Billable tools count toward Custom message usage.
Common errors
| Status | Meaning | Fix |
|---|---|---|
| 400 | Invalid JSON, missing agentId, or tool rejected input | Check the request body against the tool schema |
| 401 | Missing, invalid, or wrong-organization key | Re-issue the key and confirm the agent belongs to it |
| 403 | Key missing the required scope, or plan lacks API access | Add the scope, or confirm you are on Custom |
| 404 | Agent not found or paused | Check the public ID and unpause the agent |