> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Mid-call Action abrufen

> Rufe eine spezifische Mid-call Action anhand der ID ab

Dieser Endpunkt ermöglicht es dir, detaillierte Informationen über eine spezifische Mid-call Action abzurufen.

### Header

<ParamField header="Authorization" type="string" required>
  Bearer-Token zur Authentifizierung
</ParamField>

<ParamField header="Content-Type" type="string" required>
  Muss `application/json` sein
</ParamField>

<ParamField header="Accept" type="string" required>
  Muss `application/json` sein
</ParamField>

### Pfad-Parameter

<ParamField path="id" type="integer" required>
  Die eindeutige Kennung der Mid-call Action
</ParamField>

### Antwortfelder

<ResponseField name="id" type="integer">
  Die eindeutige Kennung der Mid-call Action
</ResponseField>

<ResponseField name="name" type="string">
  Der Name der Mid-call Action
</ResponseField>

<ResponseField name="description" type="string">
  Detaillierte Erklärung, wann und wie die KI diese Mid-call Action verwenden soll
</ResponseField>

<ResponseField name="type" type="string">
  Mid-call-Action-Typ: `http` oder `automation`
</ResponseField>

<ResponseField name="endpoint" type="string">
  Die API-Endpunkt-URL, die aufgerufen wird
</ResponseField>

<ResponseField name="method" type="string">
  HTTP-Methode (GET, POST, PUT, PATCH, DELETE)
</ResponseField>

<ResponseField name="body_format" type="string">
  Request-Body-Kodierung: `json` oder `form`
</ResponseField>

<ResponseField name="timeout" type="integer">
  Request-Timeout in Sekunden (1-30)
</ResponseField>

<ResponseField name="headers" type="array">
  HTTP-Header, die mit der Anfrage gesendet werden

  <Expandable title="Header-Eigenschaften">
    <ResponseField name="name" type="string">
      Header-Name
    </ResponseField>

    <ResponseField name="value" type="string">
      Header-Wert
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="static_fields" type="array">
  Feste Schlüssel/Wert-Paare, die immer mit der Anfrage gesendet werden

  <Expandable title="static_fields-Eigenschaften">
    <ResponseField name="key" type="string">
      Feld-Schlüssel
    </ResponseField>

    <ResponseField name="value" type="string">
      Feld-Wert
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="schema" type="array">
  Parameter, die die KI extrahiert und an den Endpunkt sendet

  <Expandable title="Schema-Eigenschaften">
    <ResponseField name="name" type="string">
      Parameter-Name
    </ResponseField>

    <ResponseField name="type" type="string">
      Parameter-Typ (string, number, float, boolean)
    </ResponseField>

    <ResponseField name="description" type="string">
      Beschreibung, um der KI zu helfen, diesen Parameter zu extrahieren
    </ResponseField>

    <ResponseField name="required" type="boolean">
      Ob die KI diesen Parameter erfassen muss
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO-8601-Zeitstempel der Erstellung
</ResponseField>

<ResponseField name="updated_at" type="string">
  ISO-8601-Zeitstempel der letzten Aktualisierung
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null}
  {
    "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.",
    "type": "http",
    "endpoint": "https://api.openweathermap.org/data/2.5/weather?city={city}",
    "method": "GET",
    "body_format": "json",
    "timeout": 10,
    "headers": [
      {
        "name": "Content-Type",
        "value": "application/json"
      },
      {
        "name": "Authorization",
        "value": "Bearer sk_..."
      }
    ],
    "static_fields": [],
    "schema": [
      {
        "name": "city",
        "type": "string",
        "description": "The city name to get weather for",
        "required": true
      },
      {
        "name": "days",
        "type": "number",
        "description": "Number of forecast days",
        "required": false
      }
    ],
    "created_at": "2025-10-10T12:00:00.000000Z",
    "updated_at": "2025-10-10T12:00:00.000000Z"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "message": "Tool not found"
  }
  ```
</ResponseExample>

### Mid-call Actions Assistenten zuweisen

Um diese Mid-call Action mit einem Assistenten zu verwenden, siehe:

* **[Assistent erstellen](/de/api-reference/assistants/create)** — Mid-call Actions mit dem `tool_ids`-Parameter zuweisen
* **[Assistent aktualisieren](/de/api-reference/assistants/update)** — Mid-call-Action-Zuweisungen mit dem `tool_ids`-Parameter verwalten

<Tip>
  Statt einzelner HTTP-Aktionen ein ganzes Toolset auf einmal? Externen **MCP-Server** verbinden — Tools werden automatisch erkannt. Siehe [MCP-Server](/de/platform/mcp-servers).
</Tip>