Skip to content
DashboardGet API key

Update tool

View .md
PATCH

Update a tool.

Authorization

  • Authorizationheaderrequired

    Bearer YOUR_API_KEY. Create a key in the dashboard.

Path parameters

  • senderIdstringrequired
  • toolIdstringrequired

Body

application/json

  • namestring
    Limitsmax length 100
  • descriptionstring
    Limitsmax length 500
  • parametersobject
    3 properties
    • typestringrequired
      One ofobject
    • propertiesobjectrequired
      1 properties
      • {key}object
        2 properties
        • typestring
        • descriptionstring
    • requiredstring[]required
  • webhookUrlstring<uri>
  • webhookSecretstringnullable
  • enabledboolean

Responses

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

400Invalid request.
  • codestringrequired
  • messagestringrequired
  • detailsobject
401Unauthorized.
  • codestringrequired
  • messagestringrequired
  • detailsobject
404Tool not found.
  • codestringrequired
  • messagestringrequired
  • detailsobject