WayloAIWaylo Docs
APIReferenceTools

Update tool

PATCH
/tools/{id}

Change any part of the definition except its workspace and its type. A sent config replaces the stored one whole. Send active: false to retire it. A new name is refused (409) if another tool in the workspace has it, or if it collides on an agent carrying the tool; a model-facing name reserved by the API is refused (400).

Access: workspace_admin · API key tools:write

Authorization

api-key
headerAuthorizationBearer <sk_waylo_<lookup><secret><checksum>>

Path Parameters

id*string

Header Parameters

Authorization*string

Your API key.

Request Body

application/json
  1. body
name?string

The function name the model calls. Letters, numbers, underscore and dash only; max 64.

Match^[\w-]{1,64}$
Lengthlength <= 64
description?string
Lengthlength <= 1000
parameters?

JSON Schema for the model-supplied arguments. Property names become the model arguments and are referenceable as {{name}} in the config url, headers and staticBody. A property cannot take the name of a context variable (session.id, workspace.id, agent.id, caller.number, now).

feedback?
config?|||
credentialId?|
Formatuuid
active?boolean

Response Body

Updated

application/json
  1. response
id*string
workspaceId*string
name*string
feedback*
credentialId*|
Formatuuid
active*boolean
agentCount*number
createdByUserId*|
Formatuuid
createdByUserName*string|null
updatedByUserId*|
Formatuuid
updatedByUserName*string|null
createdAt*string
Formatdate-time
updatedAt*string
Formatdate-time
type*"api_request"
Value in"api_request"
description*string
parameters*
config*
Example Request
curl -X PATCH 'https://api.poc.app.waylovoice.ai/tools/string' \  -H 'Authorization: Bearer sk_waylo_...' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "id": "string",  "workspaceId": "string",  "name": "string",  "feedback": {    "ack": [      "string"    ],    "filler": [      "string"    ]  },  "credentialId": "f568fec0-10b6-4b94-9daf-e62c50c9bf3e",  "active": true,  "agentCount": 0,  "createdByUserId": "4d2aef9a-17b0-44e6-902e-616812033620",  "createdByUserName": "string",  "updatedByUserId": "b38eaad7-8efa-49e7-b0aa-619916a3821e",  "updatedByUserName": "string",  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z",  "type": "api_request",  "description": "string",  "parameters": {},  "config": {    "method": "GET",    "url": "string",    "headers": {      "property1": "string",      "property2": "string"    },    "staticBody": {},    "timeoutMs": 0  }}