List Mid-call Actions

curl --request GET \
  --url https://app.famulor.de/api/user/tools \
  --header 'Accept: <accept>' \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>'

const options = {
  method: 'GET',
  headers: {
    Authorization: '<authorization>',
    'Content-Type': '<content-type>',
    Accept: '<accept>'
  }
};

fetch('https://app.famulor.de/api/user/tools', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://app.famulor.de/api/user/tools"

headers = {
    "Authorization": "<authorization>",
    "Content-Type": "<content-type>",
    "Accept": "<accept>"
}

response = requests.get(url, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.famulor.de/api/user/tools",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: <accept>",
    "Authorization: <authorization>",
    "Content-Type: <content-type>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.famulor.de/api/user/tools"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "<content-type>")
	req.Header.Add("Accept", "<accept>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "data": [
    {
      "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"
    },
    {
      "id": 2,
      "name": "send_notification",
      "description": "Use this tool to send a notification to the customer. Call this when customer requests updates.",
      "type": "http",
      "endpoint": "https://api.yourcompany.com/notifications/send",
      "method": "POST",
      "body_format": "json",
      "timeout": 15,
      "headers": [
        {
          "name": "Content-Type",
          "value": "application/json"
        }
      ],
      "static_fields": [
        {
          "key": "caller",
          "value": "{{customer_phone}}"
        }
      ],
      "schema": [
        {
          "name": "message",
          "type": "string",
          "description": "The notification message to send",
          "required": true
        },
        {
          "name": "send_sms",
          "type": "boolean",
          "description": "Whether to also send SMS notification",
          "required": false
        }
      ],
      "created_at": "2025-10-09T14:30:00.000000Z",
      "updated_at": "2025-10-10T09:15:00.000000Z"
    }
  ]
}

GET

api

user

tools

List Mid-call Actions

curl --request GET \
  --url https://app.famulor.de/api/user/tools \
  --header 'Accept: <accept>' \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>'

const options = {
  method: 'GET',
  headers: {
    Authorization: '<authorization>',
    'Content-Type': '<content-type>',
    Accept: '<accept>'
  }
};

fetch('https://app.famulor.de/api/user/tools', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://app.famulor.de/api/user/tools"

headers = {
    "Authorization": "<authorization>",
    "Content-Type": "<content-type>",
    "Accept": "<accept>"
}

response = requests.get(url, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.famulor.de/api/user/tools",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: <accept>",
    "Authorization: <authorization>",
    "Content-Type: <content-type>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.famulor.de/api/user/tools"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "<content-type>")
	req.Header.Add("Accept", "<accept>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "data": [
    {
      "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"
    },
    {
      "id": 2,
      "name": "send_notification",
      "description": "Use this tool to send a notification to the customer. Call this when customer requests updates.",
      "type": "http",
      "endpoint": "https://api.yourcompany.com/notifications/send",
      "method": "POST",
      "body_format": "json",
      "timeout": 15,
      "headers": [
        {
          "name": "Content-Type",
          "value": "application/json"
        }
      ],
      "static_fields": [
        {
          "key": "caller",
          "value": "{{customer_phone}}"
        }
      ],
      "schema": [
        {
          "name": "message",
          "type": "string",
          "description": "The notification message to send",
          "required": true
        },
        {
          "name": "send_sms",
          "type": "boolean",
          "description": "Whether to also send SMS notification",
          "required": false
        }
      ],
      "created_at": "2025-10-09T14:30:00.000000Z",
      "updated_at": "2025-10-10T09:15:00.000000Z"
    }
  ]
}

This endpoint allows you to retrieve all Mid-call Actions. Mid-call Actions enable your AI assistants to interact with external APIs during a call.

Headers

string

required

Bearer token for authentication

string

required

Must be application/json

string

required

Must be application/json

Response Fields

array

Array of Mid-call Actions

Show properties

integer

The unique identifier of the Mid-call Action

string

The name of the Mid-call Action

string

Detailed explanation of when and how the AI should use this Mid-call Action

string

Mid-call Action type: http or automation

string

The API endpoint URL that will be called

string

HTTP method (GET, POST, PUT, PATCH, DELETE)

string

Request body encoding: json or form

integer

Request timeout in seconds (1-30)

array

HTTP headers to send with the request

Show header properties

string

Header name

string

Header value

array

Fixed key/value pairs always sent with the request

Show static_fields properties

string

Field key

string

Field value

array

Parameters that the AI will extract and send to the endpoint

Show schema properties

string

Parameter name

string

Parameter type (string, number, float, boolean)

string

Description to help AI understand how to extract this parameter

boolean

Whether the AI must collect this parameter

string

ISO 8601 timestamp when the Mid-call Action was created

string

ISO 8601 timestamp when the Mid-call Action was last updated

{
  "data": [
    {
      "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"
    },
    {
      "id": 2,
      "name": "send_notification",
      "description": "Use this tool to send a notification to the customer. Call this when customer requests updates.",
      "type": "http",
      "endpoint": "https://api.yourcompany.com/notifications/send",
      "method": "POST",
      "body_format": "json",
      "timeout": 15,
      "headers": [
        {
          "name": "Content-Type",
          "value": "application/json"
        }
      ],
      "static_fields": [
        {
          "key": "caller",
          "value": "{{customer_phone}}"
        }
      ],
      "schema": [
        {
          "name": "message",
          "type": "string",
          "description": "The notification message to send",
          "required": true
        },
        {
          "name": "send_sms",
          "type": "boolean",
          "description": "Whether to also send SMS notification",
          "required": false
        }
      ],
      "created_at": "2025-10-09T14:30:00.000000Z",
      "updated_at": "2025-10-10T09:15:00.000000Z"
    }
  ]
}

Assigning Mid-call Actions to Assistants

To use these Mid-call Actions with assistants, see:

Create Assistant — Attach Mid-call Actions using the tool_ids parameter
Update Assistant — Manage Mid-call Action assignments using the tool_ids parameter

Need a whole toolset instead of building HTTP actions one by one? Connect an external MCP server — tools are discovered automatically. See MCP Servers.

Delete campaign Get Mid-call Action

API Reference

AI Assistants

Folders

Labels

Leads

Campaigns

Mid Call Actions

AI Chatbot

AI Replies

Knowledgebases

SMS

WhatsApp

Phone Numbers

SIP Trunks

Calls

Webhooks

List Mid-call Actions

Headers

Response Fields

Assigning Mid-call Actions to Assistants

​Headers

​Response Fields

​Assigning Mid-call Actions to Assistants

Headers

Response Fields

Assigning Mid-call Actions to Assistants