Skip to content
DashboardGet API key

List tools

View .md
GET

List tools for an agent.

Authorization

  • Authorizationheaderrequired

    Bearer YOUR_API_KEY. Create a key in the dashboard.

Path parameters

  • senderIdstringrequired

Query parameters

  • enabledboolean
  • limitinteger
    Default50
    Limitsmax 100
  • cursorstring

Responses

200List of tools.
  • itemsobject[]required
    10 properties
    • idstringrequired
    • agentIdstringrequired
    • namestringrequired
    • descriptionstringrequired

      Description for the LLM to understand when to use this tool.

    • parametersobjectrequired
      3 properties
      • typestringrequired
        One ofobject
      • propertiesobjectrequired
        1 properties
        • {key}object
          2 properties
          • typestring
          • descriptionstring
      • requiredstring[]required
    • webhookUrlstring<uri>required

      HTTPS URL to call when the tool is executed.

    • enabledbooleanrequired
    • createdAtstring<date-time>required
    • updatedAtstring<date-time>required
    • webhookSecretstring

      Signing secret for this tool's webhook. Returned only when the tool is created, never on a later read.

      Zavu generates one if you do not supply it, and signs every call to this tool with it: X-Zavu-Signature: <hex>, the HMAC-SHA256 of the request body. Verify it before trusting the call. Lost it? Rotate with POST /v1/senders/{senderId}/agent/tools/{toolId}/webhook/secret.

  • nextCursorstringnullable
400Invalid query parameters. `enabled` must be `true` or `false`.
  • codestringrequired
  • messagestringrequired
  • detailsobject
401Unauthorized.
  • codestringrequired
  • messagestringrequired
  • detailsobject
404Agent not found.
  • codestringrequired
  • messagestringrequired
  • detailsobject