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

# Get Mid-call Action

`GET /user/tools/{id}`

## Request

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

Retrieve detailed information about a specific Mid-call Action

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

## Path parameters

- `id` integer, required

## Response `200`

Response

- object
  - `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.
- `404`: Not Found
- `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)