Zum Hauptinhalt springen
PUT
https://app.autocalls.ai/api/
/
user
/
tools
/
{id}
Mid-Call-Tool aktualisieren
curl --request PUT \
  --url https://app.autocalls.ai/api/user/tools/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "endpoint": "<string>",
  "method": "<string>",
  "timeout": 123,
  "headers": [
    {
      "name": "<string>",
      "value": "<string>"
    }
  ],
  "schema": [
    {
      "name": "<string>",
      "type": "<string>",
      "description": "<string>"
    }
  ]
}
'
{
  "message": "Tool erfolgreich aktualisiert",
  "data": {
    "id": 1,
    "name": "update_customer_info",
    "description": "Verwenden Sie dieses Tool, um Kundeninformationen im System zu aktualisieren.",
    "endpoint": "https://api.yourcompany.com/customers/update",
    "method": "POST",
    "timeout": 15,
    "headers": [
      {
        "name": "Content-Type",
        "value": "application/json"
      }
    ],
    "schema": [
      {
        "name": "customer_name",
        "type": "string",
        "description": "Vollständiger Name des Kunden"
      },
      {
        "name": "customer_age",
        "type": "number",
        "description": "Alter des Kunden"
      },
      {
        "name": "newsletter_subscription",
        "type": "boolean",
        "description": "Ob der Kunde den Newsletter abonnieren möchte"
      }
    ],
    "created_at": "2025-10-10T12:00:00.000000Z",
    "updated_at": "2025-10-10T14:30:00.000000Z"
  }
}
Dieser Endpunkt ermöglicht es Ihnen, ein bestehendes Mid-Call-Tool zu aktualisieren. Alle Felder sind optional - geben Sie nur die Felder an, die Sie aktualisieren möchten.

Pfad-Parameter

id
integer
required
Eindeutiger Bezeichner des zu aktualisierenden Tools

Anfragekörper-Parameter

name
string
Tool-Name - darf nur Kleinbuchstaben und Unterstriche enthalten und muss mit einem Buchstaben beginnen
description
string
Detaillierte Erklärung, wann und wie die KI dieses Tool verwenden soll (max. 255 Zeichen)
endpoint
string
Gültige URL des aufzurufenden API-Endpunkts
method
string
HTTP-Methode: GET, POST, PUT, PATCH oder DELETE
timeout
integer
Anfrage-Timeout in Sekunden (1-30)
headers
array
Mit der Anfrage zu sendende HTTP-Header (ersetzt vorhandene Header)
schema
array
Parameter-Schema (ersetzt vorhandenes Schema)

Antwortfelder

message
string
Erfolgsmeldung
data
object
Das aktualisierte Tool-Objekt mit allen aktuellen Werten
{
  "message": "Tool erfolgreich aktualisiert",
  "data": {
    "id": 1,
    "name": "update_customer_info",
    "description": "Verwenden Sie dieses Tool, um Kundeninformationen im System zu aktualisieren.",
    "endpoint": "https://api.yourcompany.com/customers/update",
    "method": "POST",
    "timeout": 15,
    "headers": [
      {
        "name": "Content-Type",
        "value": "application/json"
      }
    ],
    "schema": [
      {
        "name": "customer_name",
        "type": "string",
        "description": "Vollständiger Name des Kunden"
      },
      {
        "name": "customer_age",
        "type": "number",
        "description": "Alter des Kunden"
      },
      {
        "name": "newsletter_subscription",
        "type": "boolean",
        "description": "Ob der Kunde den Newsletter abonnieren möchte"
      }
    ],
    "created_at": "2025-10-10T12:00:00.000000Z",
    "updated_at": "2025-10-10T14:30:00.000000Z"
  }
}

Tool-Zuweisungen verwalten

Um dieses Tool an Assistenten anzuhängen oder zu trennen, verwenden Sie die Assistant-API:
  • Assistenten erstellen - Verwenden Sie den Parameter tool_ids, um Tools beim Erstellen eines Assistenten anzuhängen
  • Assistenten aktualisieren - Verwenden Sie den Parameter tool_ids, um zu verwalten, welche Tools einem Assistenten zugewiesen sind