v1

latestOpenAPI 3.0.0Proprietary2026-08-062711471.0 MB

Custom Tools

Update a custom tool

Updates a custom tool (API call tool). Requires a USER API key. The tool type cannot be changed.

put/public/v1/tools/{toolId}

Path parameters

toolIdnumber nullable

Example:123

Request body

namestring

descriptionstring

status'ACTIVE' | 'PAUSED'

method'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'

urlstring uri

bodystring

Raw request body template (typically a JSON string). Interpolate argument values with single braces, e.g. {contactName} (not double braces).

Example request

{
  "name": "Fetch contact",
  "description": "Fetches a contact from the external CRM",
  "status": "ACTIVE",
  "method": "GET",
  "url": "https://api.example.com/contacts/123",
  "body": "{\"name\":\"{contactName}\"}",
  "arguments": [
    {
      "name": "contactId",
      "description": "The contact ID to fetch",
      "dataType": "STRING",
      "required": true,
      "defaultValue": "normal"
    }
  ],
  "headers": [
    {
      "key": "Authorization",
      "value": "Bearer {apiKey}"
    }
  ],
  "queryParams": [
    {
      "key": "limit",
      "value": "10"
    }
  ]
}

Response

Updated tool

idnumber required

namestring required

descriptionstring required

createdAtstring required

updatedAtstring required

status'PAUSED' | 'ACTIVE' | 'DELETED' nullable

method'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' nullable

urlstring nullable

bodystring nullable

type'API_CALL' | 'WHATSAPP_TEMPLATE_MESSAGE' required

Example response

{
  "id": 123,
  "name": "Fetch contact",
  "description": "Fetches a contact from the external CRM",
  "createdAt": "2024-01-01T12:00:00Z",
  "updatedAt": "2024-01-01T12:00:00Z",
  "status": "ACTIVE",
  "method": "GET",
  "url": "https://api.example.com/contacts/123",
  "body": "example",
  "arguments": [
    {
      "name": "example",
      "description": "example",
      "dataType": "STRING",
      "defaultValue": "example"
    }
  ],
  "headers": [
    {
      "key": "Authorization",
      "value": "Bearer {apiKey}"
    }
  ],
  "queryParams": [
    {
      "key": "limit",
      "value": "10"
    }
  ],
  "type": "API_CALL"
}