Update Mid-call Action

curl --request PUT \
  --url https://app.famulor.de/api/user/tools/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "endpoint": "<string>",
  "method": "<string>",
  "body_format": "<string>",
  "timeout": 123,
  "headers": [
    {
      "name": "<string>",
      "value": "<string>"
    }
  ],
  "static_fields": [
    {
      "key": "<string>",
      "value": "<string>"
    }
  ],
  "schema": [
    {
      "name": "<string>",
      "type": "<string>",
      "description": "<string>",
      "required": true
    }
  ]
}
'

import requests

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

payload = {
    "name": "<string>",
    "description": "<string>",
    "endpoint": "<string>",
    "method": "<string>",
    "body_format": "<string>",
    "timeout": 123,
    "headers": [
        {
            "name": "<string>",
            "value": "<string>"
        }
    ],
    "static_fields": [
        {
            "key": "<string>",
            "value": "<string>"
        }
    ],
    "schema": [
        {
            "name": "<string>",
            "type": "<string>",
            "description": "<string>",
            "required": True
        }
    ]
}
headers = {"Content-Type": "application/json"}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    description: '<string>',
    endpoint: '<string>',
    method: '<string>',
    body_format: '<string>',
    timeout: 123,
    headers: [{name: '<string>', value: '<string>'}],
    static_fields: [{key: '<string>', value: '<string>'}],
    schema: [{name: '<string>', type: '<string>', description: '<string>', required: true}]
  })
};

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.famulor.de/api/user/tools/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'description' => '<string>',
    'endpoint' => '<string>',
    'method' => '<string>',
    'body_format' => '<string>',
    'timeout' => 123,
    'headers' => [
        [
                'name' => '<string>',
                'value' => '<string>'
        ]
    ],
    'static_fields' => [
        [
                'key' => '<string>',
                'value' => '<string>'
        ]
    ],
    'schema' => [
        [
                'name' => '<string>',
                'type' => '<string>',
                'description' => '<string>',
                'required' => true
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"endpoint\": \"<string>\",\n  \"method\": \"<string>\",\n  \"body_format\": \"<string>\",\n  \"timeout\": 123,\n  \"headers\": [\n    {\n      \"name\": \"<string>\",\n      \"value\": \"<string>\"\n    }\n  ],\n  \"static_fields\": [\n    {\n      \"key\": \"<string>\",\n      \"value\": \"<string>\"\n    }\n  ],\n  \"schema\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\",\n      \"description\": \"<string>\",\n      \"required\": true\n    }\n  ]\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://app.famulor.de/api/user/tools/{id}")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"endpoint\": \"<string>\",\n  \"method\": \"<string>\",\n  \"body_format\": \"<string>\",\n  \"timeout\": 123,\n  \"headers\": [\n    {\n      \"name\": \"<string>\",\n      \"value\": \"<string>\"\n    }\n  ],\n  \"static_fields\": [\n    {\n      \"key\": \"<string>\",\n      \"value\": \"<string>\"\n    }\n  ],\n  \"schema\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\",\n      \"description\": \"<string>\",\n      \"required\": true\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.famulor.de/api/user/tools/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"endpoint\": \"<string>\",\n  \"method\": \"<string>\",\n  \"body_format\": \"<string>\",\n  \"timeout\": 123,\n  \"headers\": [\n    {\n      \"name\": \"<string>\",\n      \"value\": \"<string>\"\n    }\n  ],\n  \"static_fields\": [\n    {\n      \"key\": \"<string>\",\n      \"value\": \"<string>\"\n    }\n  ],\n  \"schema\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\",\n      \"description\": \"<string>\",\n      \"required\": true\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "message": "Tool updated successfully",
  "data": {
    "id": 1,
    "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-10T12:00:00.000000Z",
    "updated_at": "2025-10-10T14:30:00.000000Z"
  }
}

{
  "message": "Tool not found"
}

{
  "message": "Validation failed",
  "errors": {
    "name": ["Tool name must contain only letters, numbers and underscores, and start with a letter or underscore."]
  }
}

PUT

api

user

tools

{id}

Update Mid-call Action

curl --request PUT \
  --url https://app.famulor.de/api/user/tools/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "endpoint": "<string>",
  "method": "<string>",
  "body_format": "<string>",
  "timeout": 123,
  "headers": [
    {
      "name": "<string>",
      "value": "<string>"
    }
  ],
  "static_fields": [
    {
      "key": "<string>",
      "value": "<string>"
    }
  ],
  "schema": [
    {
      "name": "<string>",
      "type": "<string>",
      "description": "<string>",
      "required": true
    }
  ]
}
'

import requests

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

payload = {
    "name": "<string>",
    "description": "<string>",
    "endpoint": "<string>",
    "method": "<string>",
    "body_format": "<string>",
    "timeout": 123,
    "headers": [
        {
            "name": "<string>",
            "value": "<string>"
        }
    ],
    "static_fields": [
        {
            "key": "<string>",
            "value": "<string>"
        }
    ],
    "schema": [
        {
            "name": "<string>",
            "type": "<string>",
            "description": "<string>",
            "required": True
        }
    ]
}
headers = {"Content-Type": "application/json"}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    description: '<string>',
    endpoint: '<string>',
    method: '<string>',
    body_format: '<string>',
    timeout: 123,
    headers: [{name: '<string>', value: '<string>'}],
    static_fields: [{key: '<string>', value: '<string>'}],
    schema: [{name: '<string>', type: '<string>', description: '<string>', required: true}]
  })
};

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.famulor.de/api/user/tools/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'description' => '<string>',
    'endpoint' => '<string>',
    'method' => '<string>',
    'body_format' => '<string>',
    'timeout' => 123,
    'headers' => [
        [
                'name' => '<string>',
                'value' => '<string>'
        ]
    ],
    'static_fields' => [
        [
                'key' => '<string>',
                'value' => '<string>'
        ]
    ],
    'schema' => [
        [
                'name' => '<string>',
                'type' => '<string>',
                'description' => '<string>',
                'required' => true
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"endpoint\": \"<string>\",\n  \"method\": \"<string>\",\n  \"body_format\": \"<string>\",\n  \"timeout\": 123,\n  \"headers\": [\n    {\n      \"name\": \"<string>\",\n      \"value\": \"<string>\"\n    }\n  ],\n  \"static_fields\": [\n    {\n      \"key\": \"<string>\",\n      \"value\": \"<string>\"\n    }\n  ],\n  \"schema\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\",\n      \"description\": \"<string>\",\n      \"required\": true\n    }\n  ]\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://app.famulor.de/api/user/tools/{id}")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"endpoint\": \"<string>\",\n  \"method\": \"<string>\",\n  \"body_format\": \"<string>\",\n  \"timeout\": 123,\n  \"headers\": [\n    {\n      \"name\": \"<string>\",\n      \"value\": \"<string>\"\n    }\n  ],\n  \"static_fields\": [\n    {\n      \"key\": \"<string>\",\n      \"value\": \"<string>\"\n    }\n  ],\n  \"schema\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\",\n      \"description\": \"<string>\",\n      \"required\": true\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.famulor.de/api/user/tools/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"endpoint\": \"<string>\",\n  \"method\": \"<string>\",\n  \"body_format\": \"<string>\",\n  \"timeout\": 123,\n  \"headers\": [\n    {\n      \"name\": \"<string>\",\n      \"value\": \"<string>\"\n    }\n  ],\n  \"static_fields\": [\n    {\n      \"key\": \"<string>\",\n      \"value\": \"<string>\"\n    }\n  ],\n  \"schema\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\",\n      \"description\": \"<string>\",\n      \"required\": true\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "message": "Tool updated successfully",
  "data": {
    "id": 1,
    "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-10T12:00:00.000000Z",
    "updated_at": "2025-10-10T14:30:00.000000Z"
  }
}

{
  "message": "Tool not found"
}

{
  "message": "Validation failed",
  "errors": {
    "name": ["Tool name must contain only letters, numbers and underscores, and start with a letter or underscore."]
  }
}

Famulor 1.0 API (legacy). This page applies only to Famulor 1.0 (app.famulor.de) and is retained for legacy compatibility. For the current platform, use the Famulor 2.0 API reference.

This endpoint allows you to update an existing Mid-call Action. All fields are optional — only provide the fields you want to update.

Path Parameters

integer

required

The unique identifier of the Mid-call Action to update

Body Parameters

For Mid-call Actions linked to an Automation Platform flow, the endpoint, method, and body_format fields are ignored to protect the flow connection.

string

Mid-call Action name — letters, numbers and underscores, starting with a letter or underscore (max 64 characters)

string

Detailed explanation of when and how the AI should use this Mid-call Action (max 255 characters)

string

Valid URL of the API endpoint to call (max 2048 characters)

string

HTTP method: GET, POST, PUT, PATCH, or DELETE

string

Request body encoding for write methods: json (default) or form

integer

Request timeout in seconds (1-30)

array

HTTP headers to send with the request (replaces existing headers)

Show headers properties

string

required

Header name

string

required

Header value (supports {{variable}} substitution)

array

Fixed key/value pairs always sent with the request (replaces existing static fields)

Show static_fields properties

string

required

Field key (max 64 chars)

string

Field value (max 2048 chars; supports {{variable}} substitution)

array

Parameters schema (replaces existing schema)

Show schema properties

string

required

Parameter name (1-64 chars, starts with a letter or underscore)

string

required

Parameter type: string, number, float, or boolean

string

required

Parameter description (3-255 chars)

boolean

Whether the AI must collect this parameter (default false)

Response Fields

string

Success message

object

The updated Mid-call Action object with all current values

{
  "message": "Tool updated successfully",
  "data": {
    "id": 1,
    "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-10T12:00:00.000000Z",
    "updated_at": "2025-10-10T14:30:00.000000Z"
  }
}

{
  "message": "Tool not found"
}

{
  "message": "Validation failed",
  "errors": {
    "name": ["Tool name must contain only letters, numbers and underscores, and start with a letter or underscore."]
  }
}

Managing Mid-call Action Assignments

To attach or detach this Mid-call Action from assistants, use the Assistant API:

Create Assistant — Use the tool_ids parameter to attach Mid-call Actions when creating an assistant
Update Assistant — Use the tool_ids parameter to manage which Mid-call Actions are assigned to an assistant

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

API Reference

AI Assistants

Folders

Labels

Leads

Campaigns

Automations

Mid Call Actions

AI Chatbot

AI Replies

Knowledgebases

SMS

WhatsApp

Phone Numbers

SIP Trunks

Calls

Webhooks

Update Mid-call Action

Path Parameters

Body Parameters

Response Fields

Managing Mid-call Action Assignments

​Path Parameters

​Body Parameters

​Response Fields

​Managing Mid-call Action Assignments

Path Parameters

Body Parameters

Response Fields

Managing Mid-call Action Assignments