> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Automation abrufen

> Hole eine einzelne Famulor-Automation inkl. vollständiger Definition (Trigger und verkettete Steps).

Dieser Endpunkt gibt eine einzelne Automation zurück, die dir gehört — inklusive vollständiger Definition (Trigger und verkettete Steps), damit du sie inspizieren oder reparieren kannst.

### Path Parameters

<ParamField path="id" type="string" required>
  Die ID der Automation (aus [Automationen auflisten](/de/api-reference/automations/list))
</ParamField>

### Query Parameters

<ParamField query="include_secrets" type="boolean">
  Standardmäßig werden credential-haltige Werte in der Definition (API-Keys, Tokens, Authorization-Header) als `••• hidden` maskiert. Mit `true` werden sie unmaskiert zurückgegeben.
</ParamField>

### Response

<ResponseField name="data" type="object">
  Die Automation

  <Expandable title="data-Eigenschaften">
    <ResponseField name="id" type="string">
      Die eindeutige ID der Automation
    </ResponseField>

    <ResponseField name="name" type="string">
      Der Anzeigename der Automation
    </ResponseField>

    <ResponseField name="status" type="string">
      `enabled` oder `disabled`
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Zeitpunkt der letzten Aktualisierung
    </ResponseField>

    <ResponseField name="definition" type="object">
      Die Definition der Automation: das Trigger-Objekt mit den unter `nextAction` verketteten Steps. Das ist das Artefakt, das du bearbeitest und über [Automation aktualisieren](/de/api-reference/automations/update) zurückschickst. Das Definitionsformat steht unter [Automation erstellen](/de/api-reference/automations/create).
    </ResponseField>

    <ResponseField name="binding" type="object | null">
      Wenn die Automation an ein Assistant-Event gebunden ist: `{type, assistant_id, assistant_name}` (siehe [Automationen auflisten](/de/api-reference/automations/list)). Sonst `null`.
    </ResponseField>
  </Expandable>
</ResponseField>

Eine fehlende Automation — oder eine, die nicht zu deinem Account gehört — liefert `404` mit `{"message": "Automation not found"}`.

<ResponseExample>
  ```json 200 Response theme={null} theme={null}
  {
    "data": {
      "id": "f4EaLhOW2zoEsXXSOJP2r",
      "name": "Order lookup",
      "status": "enabled",
      "updated_at": "2026-07-24T18:23:57.259Z",
      "definition": {
        "name": "trigger",
        "type": "PIECE_TRIGGER",
        "displayName": "Catch Webhook",
        "settings": {
          "pieceName": "@activepieces/piece-webhook",
          "triggerName": "catch_webhook"
        },
        "nextAction": {
          "name": "step_1",
          "type": "PIECE",
          "displayName": "Look up the order",
          "settings": {
            "pieceName": "@activepieces/piece-http",
            "actionName": "send_request",
            "input": {
              "url": "https://api.example.com/orders",
              "method": "GET",
              "headers": {
                "Authorization": "••• hidden"
              }
            }
          }
        }
      },
      "binding": null
    }
  }
  ```

  ```json 404 Not Found theme={null} theme={null}
  {
    "message": "Automation not found"
  }
  ```
</ResponseExample>

<Tip>
  Verwandte Seiten: [Automationen auflisten](/de/api-reference/automations/list), [Automation aktualisieren](/de/api-reference/automations/update) und [Authentifizierung](/de/api-reference/authentication).
</Tip>