---
title: "Update Mid-call Action"
method: PUT
path: "/user/tools/{id}"
tags: ["Mid-Call Tools"]
---

# Update Mid-call Action

`PUT /user/tools/{id}`

## Request

- Base URL: `https://app.famulor.de/api`
- URL: `https://app.famulor.de/api/user/tools/{id}`
- Auth: HTTP bearer

Modify an existing Mid-call Action in Famulor via API. Update name, endpoint, parameters or description so AI voice agents call the right action.

[Docs](https://docs.famulor.io/api-v1/mid-call-tools/update-tool)

## Path parameters

- `id` integer, required

## Request body

- object
  - `name` string: Mid-call Action name — letters, numbers and underscores, starting with a letter or underscore (max 64 characters)
  - `description` string: Detailed explanation of when and how the AI should use this Mid-call Action (max 255 characters)
  - `endpoint` string: Valid URL of the API endpoint to call (max 2048 characters)
  - `method` string: HTTP method: `GET`, `POST`, `PUT`, `PATCH`, or `DELETE`
  - `body_format` string: Request body encoding for write methods: `json` (default) or `form`
  - `timeout` integer: Request timeout in seconds (1-30)
  - `headers` object[]: HTTP headers to send with the request (replaces existing headers)
    - `name` string, required: Header name
    - `value` string, required: Header value (supports `{{variable}}` substitution)
  - `static_fields` object[]: Fixed key/value pairs always sent with the request (replaces existing static fields)
    - `key` string, required: Field key (max 64 chars)
    - `value` string: Field value (max 2048 chars; supports `{{variable}}` substitution)
  - `schema` object[]: Parameters schema (replaces existing schema)
    - `name` string, required: Parameter name (1-64 chars, starts with a letter or underscore)
    - `type` string, required: Parameter type: `string`, `number`, `float`, or `boolean`
    - `description` string, required: Parameter description (3-255 chars)
    - `required` boolean: Whether the AI must collect this parameter (default `false`)

## Response `200`

OK

- object
  - `message` string: Success message
  - `data` object: The updated Mid-call Action object with all current values

## Other responses

- `401`: Fehlender oder ungültiger API-Key.
- `404`: Not Found
- `422`: Validation Error

---

[API](https://skmtc.dev/famulor/apis/famulor-api.md) · [All operations](https://skmtc.dev/famulor/apis/famulor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/famulor/apis/famulor-api/revisions/3b938c370721?raw)