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

# Récupérer une Mid-call Action

> Récupère des informations détaillées sur une Mid-call Action spécifique

<Warning>
  **API Famulor 1.0 (héritée).** Cette page concerne uniquement Famulor 1.0 (`app.famulor.de`) et est conservée pour la compatibilité. Pour la plateforme actuelle, consultez la [référence API Famulor 2.0](/fr/api-reference/introduction).
</Warning>

Ce point de terminaison vous permet de récupérer des informations détaillées sur une Mid-call Action spécifique.

### En-têtes

<ParamField header="Authorization" type="string" required>
  Jeton Bearer pour l'authentification
</ParamField>

<ParamField header="Content-Type" type="string" required>
  Doit être `application/json`
</ParamField>

<ParamField header="Accept" type="string" required>
  Doit être `application/json`
</ParamField>

### Paramètres de chemin

<ParamField path="id" type="integer" required>
  L'identifiant unique de la Mid-call Action
</ParamField>

### Champs de réponse

<ResponseField name="id" type="integer">
  L'identifiant unique de la Mid-call Action
</ResponseField>

<ResponseField name="name" type="string">
  Le nom de la Mid-call Action
</ResponseField>

<ResponseField name="description" type="string">
  Explication détaillée du moment et de la manière dont l'IA doit utiliser cette Mid-call Action
</ResponseField>

<ResponseField name="type" type="string">
  Type de la Mid-call Action : `http` ou `automation`
</ResponseField>

<ResponseField name="endpoint" type="string">
  L'URL du point de terminaison de l'API qui sera appelé
</ResponseField>

<ResponseField name="method" type="string">
  Méthode HTTP (GET, POST, PUT, PATCH, DELETE)
</ResponseField>

<ResponseField name="body_format" type="string">
  Encodage du corps de la requête : `json` ou `form`
</ResponseField>

<ResponseField name="timeout" type="integer">
  Délai d'expiration de la requête en secondes (1-30)
</ResponseField>

<ResponseField name="headers" type="array">
  En-têtes HTTP à envoyer avec la requête

  <Expandable title="Propriétés de header">
    <ResponseField name="name" type="string">
      Nom de l'en-tête
    </ResponseField>

    <ResponseField name="value" type="string">
      Valeur de l'en-tête
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="static_fields" type="array">
  Paires clé/valeur fixes toujours envoyées avec la requête

  <Expandable title="Propriétés de static_fields">
    <ResponseField name="key" type="string">
      Clé du champ
    </ResponseField>

    <ResponseField name="value" type="string">
      Valeur du champ
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="schema" type="array">
  Paramètres que l'IA extraira et enverra au point de terminaison

  <Expandable title="Propriétés de schema">
    <ResponseField name="name" type="string">
      Nom du paramètre
    </ResponseField>

    <ResponseField name="type" type="string">
      Type du paramètre (string, number, float, boolean)
    </ResponseField>

    <ResponseField name="description" type="string">
      Description pour aider l'IA à comprendre comment extraire ce paramètre
    </ResponseField>

    <ResponseField name="required" type="boolean">
      Indique si l'IA doit obligatoirement recueillir ce paramètre
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="created_at" type="string">
  Horodatage ISO 8601 de création de la Mid-call Action
</ResponseField>

<ResponseField name="updated_at" type="string">
  Horodatage ISO 8601 de dernière mise à jour de la Mid-call Action
</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>

### Attribuer des Mid-call Actions à des assistants

Pour utiliser cette Mid-call Action avec un assistant, consultez :

* **[Créer un assistant](/fr/api-v1/assistants/create)** — Associez des Mid-call Actions à l'aide du paramètre `tool_ids`
* **[Mettre à jour un assistant](/fr/api-v1/assistants/update)** — Gérez les attributions de Mid-call Actions à l'aide du paramètre `tool_ids`

<Tip>
  Besoin de tout un ensemble d'outils plutôt que de créer des actions HTTP une par une ? Connectez un **serveur MCP** externe — les outils sont détectés automatiquement. Voir [Serveurs MCP](/fr/api/tools-and-webhooks).
</Tip>
