GET · Authenticated credential

Search tools

Find tools that work on a task lead list. Search by action or exact tool name to get its input schema.

Set up with your AI assistant

Paste the prompt into your coding assistant. It includes setup steps and a read-only connection check.

Request

Endpoint

GET https://leadsagent.io/api/v1/tools

Set LEADSAGENT_API_KEY in your local environment. Send it in the X-API-Key header.

Bash · API base URL

export LEADSAGENT_API_BASE="https://leadsagent.io/api/v1"
# For a local backend:
# export LEADSAGENT_API_BASE="http://127.0.0.1:8001/api/v1"

Bash · curl

curl --fail-with-body --silent --show-error --request GET "$LEADSAGENT_API_BASE/tools?query=website%20status&limit=3" -H "X-API-Key: $LEADSAGENT_API_KEY"

Replace TASK_ID with data.id from a task response. In PowerShell, use curl.exe and $env:LEADSAGENT_API_KEY. Save JSON in a file and pass --data-binary @request.json.

query (string): Optional. Up to 200 characters. Omit it to list every tool in one line.
limit (integer): Optional. 1–8; default 3. Used when query is set.

The catalog is read-only. Running an ordinary tool needs leads:write.
Read the input schema before calling run-tool.

Response

data contains matching tools and a next instruction.

Example response

{
  "request_id": "6c4d0c26-8aa3-44b0-a50a-51b832b29465",
  "status": "success",
  "data": {
    "tools": [
      {
        "name": "check_website_status",
        "description": "Checks if each website works.",
        "input": {
          "type": "object",
          "properties": {}
        },
        "output_columns": [
          "website_status"
        ],
        "credits": 0,
        "runs_in_background": true
      }
    ],
    "next": "Call run_tool with task_id, tool and arguments."
  },
  "meta": {}
}

Errors and retries explains status codes and retry rules. A successful request does not mean a background task has finished.

Read as Markdown