Update Tool

PUT /api/v1/tools/{tool_uuid} — request parameters and responses from the Menace Voice API schema.

2 min read

put/api/v1/tools/{tool_uuid}

Request example

curl --request PUT \
  --url https://voice.menaceui.com/api/v1/tools/{tool_uuid} \
  --header 'authorization: <string>' \
  --header 'X-API-Key: <string>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "description": "<string>",
  "icon": "<string>",
  "icon_color": "<string>",
  "definition": {
    "schema_version": 1,
    "type": "http_api",
    "config": {
      "method": "GET",
      "url": "<string>",
      "headers": {},
      "credential_uuid": "<string>",
      "parameters": [
        {
          "name": "<string>",
          "type": "string",
          "description": "<string>",
          "required": true
        }
      ],
      "preset_parameters": [
        {
          "name": "<string>",
          "type": "string",
          "value_template": "<string>",
          "required": true
        }
      ],
      "timeout_ms": 5000,
      "customMessage": "<string>",
      "customMessageType": "text",
      "customMessageRecordingId": "<string>",
      "body_template": {}
    }
  },
  "status": "<string>"
}'

Response

{
  "id": 1,
  "tool_uuid": "<string>",
  "name": "<string>",
  "description": "<string>",
  "category": "<string>",
  "icon": "<string>",
  "icon_color": "<string>",
  "status": "<string>",
  "definition": {},
  "created_at": "2026-08-10T12:00:00Z",
  "updated_at": "2026-08-10T12:00:00Z",
  "created_by": {
    "id": 1,
    "provider_id": "<string>"
  }
}

put/api/v1/tools/{tool_uuid}

See authentication for workspace API access. Public embed and artifact endpoints use their documented session or access tokens.

Path parameters

tool_uuidstringrequired#

Headers

authorizationstring · null#

X-API-Keystring · null#

Body

application/json

namestring · null#

Show child attributes

Any of

descriptionstring · null#

Show child attributes

Any of

iconstring · null#

Show child attributes

Any of

icon_colorstring · null#

Show child attributes

Any of

definitionobject · null#

Show child attributes

Any of

statusstring · null#

Show child attributes

Any of

Responses

application/json

Successful Response

idintegerrequired#

tool_uuidstringrequired#

namestringrequired#

descriptionstring · nullrequired#

Show child attributes

Any of

categorystringrequired#

iconstring · nullrequired#

Show child attributes

Any of

icon_colorstring · nullrequired#

Show child attributes

Any of

statusstringrequired#

definitionobjectrequired#

created_atstringrequired#

updated_atstring · nullrequired#

Show child attributes

Any of

created_byobject · null#

Show child attributes

Any of

idintegerrequired#

provider_idstringrequired#

Get Tool Delete Tool