Skip to content
DashboardGet API key

Get tool

View .md
GET

Get a specific tool.

Authorization

  • Authorizationheaderrequired

    Bearer YOUR_API_KEY. Create a key in the dashboard.

Path parameters

  • senderIdstringrequired
  • toolIdstringrequired

Responses

200Tool details.
  • toolobjectrequired
    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.

401Unauthorized.
  • codestringrequired
  • messagestringrequired
  • detailsobject
404Tool not found.
  • codestringrequired
  • messagestringrequired
  • detailsobject