Developers / Tools

List tools

GET https://api.echonova.ai/v1/tools

Lists the tools in this key's workspace, paged with offset and limit. Tools show their URLs and the secret and connection ids they use, never secret values. Free. Needs the tools:write scope on the key.

Headers

Authorization string Required

Bearer, a space, then your API key, which starts with ek_. Create keys in the portal under Developers, API Keys.

Query parameters

offset integer Optional

How many items to skip.

0 to 10000default 0
limit integer Optional

How many items to return.

1 to 50default 20

Response

200 application/json Every response uses this envelope.

data object

The result.

success boolean

true for a successful call.

statusCode integer

Repeats the HTTP status.

errorMessage string or null

null on success.

Errors

Same envelope, with success false and data null. All errors

GET /v1/tools

curl "https://api.echonova.ai/v1/tools" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "items": [
      {
        "id": "6650a1b2c3d4e5f6a7b8c9d0",
        "name": "Order lookup",
        "type": "webhook",
        "description": "Finds an order by its number.",
        "createdAt": "2026-11-01T10:00:00.000Z",
        "updatedAt": "2026-11-01T10:00:00.000Z",
        "webhook": {
          "url": "https://api.example.com/orders/{orderId}",
          "method": "GET",
          "timeoutMs": 10000,
          "connectionId": "6650a1b2c3d4e5f6a7b8c9d0",
          "parameters": [
            {
              "location": "header",
              "name": "orderId",
              "dataType": "string",
              "required": true,
              "description": "Finds an order by its number.",
              "valueType": "llm",
              "secretId": "YOUR_SECRET_ID"
            }
          ]
        },
        "openapi": {
          "apiTitle": "Orders API",
          "operationCount": 12,
          "status": "ready",
          "baseUrl": "https://api.example.com",
          "includeOperations": [
            "getOrder"
          ],
          "authConnectionId": "YOUR_AUTH_CONNECTION_ID",
          "error": null
        },
        "integration": {
          "provider": "slack",
          "key": "add_reaction"
        }
      }
    ],
    "total": 1
  },
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}