Skip to main content
GET
/
user
/
tools
Mid-Call-Tools auflisten
curl --request GET \
  --url https://app.famulor.de/api/user/tools \
  --header 'Accept: <accept>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>'
[
  {
    "id": 1,
    "name": "get_weather",
    "description": "Use this tool to get the current weather in a specific city. Call this when the customer asks about weather conditions.",
    "endpoint": "https://api.openweathermap.org/data/2.5/weather",
    "method": "GET",
    "timeout": 10,
    "headers": [
      {
        "name": "Content-Type",
        "value": "application/json"
      },
      {
        "name": "Authorization",
        "value": "Bearer sk_..."
      }
    ],
    "schema": [
      {
        "name": "city",
        "type": "string",
        "description": "The city name to get weather for"
      },
      {
        "name": "temperature",
        "type": "number",
        "description": "Current temperature value"
      },
      {
        "name": "is_raining",
        "type": "boolean",
        "description": "Whether it is currently raining"
      }
    ],
    "created_at": "2025-10-10T12:00:00.000000Z",
    "updated_at": "2025-10-10T12:00:00.000000Z"
  },
  {
    "id": 2,
    "name": "send_notification",
    "description": "Use this tool to send a notification to the customer. Call this when customer requests updates.",
    "endpoint": "https://api.yourcompany.com/notifications/send",
    "method": "POST",
    "timeout": 15,
    "headers": [
      {
        "name": "Content-Type",
        "value": "application/json"
      }
    ],
    "schema": [
      {
        "name": "message",
        "type": "string",
        "description": "The notification message to send"
      },
      {
        "name": "priority_level",
        "type": "number",
        "description": "Priority level from 1 to 5"
      },
      {
        "name": "send_sms",
        "type": "boolean",
        "description": "Whether to also send SMS notification"
      }
    ],
    "created_at": "2025-10-09T14:30:00.000000Z",
    "updated_at": "2025-10-10T09:15:00.000000Z"
  }
]
Dieser Endpunkt ermöglicht es Ihnen, alle Mid-Call-Tools abzurufen. Mid-Call-Tools ermöglichen es Ihren KI-Assistenten, während eines Anrufs mit externen APIs zu interagieren.
​
Authorization
string
required
Bearer-Token für die Authentifizierung
​
Content-Type
string
required
Muss application/json sein
​
Accept
string
required
Muss application/json sein

​
Antwortfelder

​
data
array
Array von Mid-Call-Tools
[
  {
    "id": 1,
    "name": "get_weather",
    "description": "Use this tool to get the current weather in a specific city. Call this when the customer asks about weather conditions.",
    "endpoint": "https://api.openweathermap.org/data/2.5/weather",
    "method": "GET",
    "timeout": 10,
    "headers": [
      {
        "name": "Content-Type",
        "value": "application/json"
      },
      {
        "name": "Authorization",
        "value": "Bearer sk_..."
      }
    ],
    "schema": [
      {
        "name": "city",
        "type": "string",
        "description": "The city name to get weather for"
      },
      {
        "name": "temperature",
        "type": "number",
        "description": "Current temperature value"
      },
      {
        "name": "is_raining",
        "type": "boolean",
        "description": "Whether it is currently raining"
      }
    ],
    "created_at": "2025-10-10T12:00:00.000000Z",
    "updated_at": "2025-10-10T12:00:00.000000Z"
  },
  {
    "id": 2,
    "name": "send_notification",
    "description": "Use this tool to send a notification to the customer. Call this when customer requests updates.",
    "endpoint": "https://api.yourcompany.com/notifications/send",
    "method": "POST",
    "timeout": 15,
    "headers": [
      {
        "name": "Content-Type",
        "value": "application/json"
      }
    ],
    "schema": [
      {
        "name": "message",
        "type": "string",
        "description": "The notification message to send"
      },
      {
        "name": "priority_level",
        "type": "number",
        "description": "Priority level from 1 to 5"
      },
      {
        "name": "send_sms",
        "type": "boolean",
        "description": "Whether to also send SMS notification"
      }
    ],
    "created_at": "2025-10-09T14:30:00.000000Z",
    "updated_at": "2025-10-10T09:15:00.000000Z"
  }
]

​
Tools zu Assistenten zuweisen

Um diese Tools mit Assistenten zu verwenden, siehe: