---
title: "List Mid-call Actions"
method: GET
path: "/user/tools"
tags: ["Mid-Call Tools"]
---

# List Mid-call Actions

`GET /user/tools`

## Request

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

Retrieve all Mid-call Actions available in your Famulor account via API. Useful for inventory, debugging and attaching actions to AI voice assistants.

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

## Response `200`

Response

- object
  - `data` object[]: Array of Mid-call Actions
    - `id` integer: The unique identifier of the Mid-call Action
    - `name` string: The name of the Mid-call Action
    - `description` string: Detailed explanation of when and how the AI should use this Mid-call Action
    - `type` string: Mid-call Action type: `http` or `automation`
    - `endpoint` string: The API endpoint URL that will be called
    - `method` string: HTTP method (GET, POST, PUT, PATCH, DELETE)
    - `body_format` string: Request body encoding: `json` or `form`
    - `timeout` integer: Request timeout in seconds (1-30)
    - `headers` object[]: HTTP headers to send with the request
      - `name` string: Header name
      - `value` string: Header value
    - `static_fields` object[]: Fixed key/value pairs always sent with the request
      - `key` string: Field key
      - `value` string: Field value
    - `schema` object[]: Parameters that the AI will extract and send to the endpoint
      - `name` string: Parameter name
      - `type` string: Parameter type (string, number, float, boolean)
      - `description` string: Description to help AI understand how to extract this parameter
      - `required` boolean: Whether the AI must collect this parameter
    - `created_at` string: ISO 8601 timestamp when the Mid-call Action was created
    - `updated_at` string: ISO 8601 timestamp when the Mid-call Action was last updated

## Other responses

- `401`: Fehlender oder ungültiger API-Key.
- `422`: Die Anfrage ist inhaltlich ungültig.

---

[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)