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

# Get automation

> Get a single automation, including its full definition

This endpoint returns a single automation you own, including its full definition (the trigger and its chained steps) so you can inspect or repair it.

### Path Parameters

**id** `string` *required*

The ID of the automation (from [List automations](https://docs.lacy.ai/api-reference/automations/list-automations.md))

### Query Parameters

**include\_secrets** `boolean`

By default, credential-bearing values inside the definition (API keys, tokens, `Authorization` headers) are masked as `••• hidden`. Pass `true` to return them unmasked.

### Response

**data** `object`

The automation

**data properties**

**id** `string`

The unique ID of the automation

**name** `string`

The display name of the automation

**status** `string`

`enabled` or `disabled`

**updated\_at** `string`

When the automation was last updated

**definition** `object`

The automation's definition: the trigger object with its steps chained under `nextAction`. This is the artifact you edit and send back through [Update automation](https://docs.lacy.ai/api-reference/automations/update-automation.md) to repair or extend the automation. See [Create automation](https://docs.lacy.ai/api-reference/automations/create-automation.md) for the definition format.

**binding** `object | null`

When the automation is attached to an assistant event: `{type, assistant_id, assistant_name}` (see [List automations](https://docs.lacy.ai/api-reference/automations/list-automations.md)). Otherwise `null`.

A missing automation — or one that does not belong to your account — returns a `404` with `{"message": "Automation not found"}`.

```json 200 Response 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 Response theme={null}
{
  "message": "Automation not found"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.