# App handler invocations

> Recent handler invocations against the live app: status, timing, cache hits, and errors.

Source: https://docs.generalinput.com/api/workflows/app-invocations



<Endpoint method="GET" path="/v1/workflows/:id/app/invocations" />

<Access scope="workflows:manage" />

## Query parameters [#query-parameters]

| Name      | Type    | Notes                               |
| --------- | ------- | ----------------------------------- |
| `handler` | string  | Only this handler.                  |
| `errors`  | boolean | `true` for failed invocations only. |
| `limit`   | integer | 1 to 100. Default 20.               |

## Response [#response]

```json
{
  "invocations": [
    {
      "id": "b7f0c412-58ad-4e93-9c26-0f31a85be7d4",
      "handlerName": "listCustomers",
      "status": "error",
      "inputPreview": "{\"limit\":50}",
      "outputPreview": null,
      "errorMessage": "Stripe returned 429",
      "durationMs": 812,
      "cacheHit": false,
      "createdAt": "2026-09-03T10:05:00.000Z"
    }
  ]
}
```

`status` is `ok`, `error`, or `timeout`.