> For the complete documentation index, see [llms.txt](https://docs.ebbot.ai/ebbot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/list-modules.md).

# List Easit Modules

Discover the modules available in the connected Easit environment.

**Action identifier:** `list_modules`.

### Inputs

This action takes no input fields.

### Output

Paths are relative to this action's output. Select them from the builder's variable picker rather than typing them. A field that is null or empty was not returned by Easit; it is not proof that the value is empty in Easit.

| Path                 | Type             | Meaning                                      |
| -------------------- | ---------------- | -------------------------------------------- |
| `modules`            | array of objects | Modules visible to the connection API token. |
| `modules[].id`       | integer          | Tenant-specific numeric module id.           |
| `modules[].name`     | string           | Localized module name.                       |
| `modules[].internal` | boolean          | Whether Easit marks the module as internal.  |

### Declared errors

Instead of the output above, the action can return one of these objects. Check for them before using the output in a later step.

#### `EasitUnavailable`

Easit could not be reached, or refused the request.

| Path        | Type           | Meaning                                                        |
| ----------- | -------------- | -------------------------------------------------------------- |
| `reachable` | boolean        | False when Easit could not be reached or rejected the request. |
| `endpoint`  | string \| null | Easit API endpoint involved in the failed request, when known. |
| `error`     | string         | Safe error code or diagnostic without credentials.             |
| `hint`      | string \| null | Suggested connection or permission check, when available.      |

### Behavior and limits

Lists the modules available to the connection's API token. Takes no arguments.

Returns `modules`, each with its tenant-specific numeric `id`, localized `name`, and `internal` flag. Use the administrator's module system name for normal setup; never copy a module id between tenants.

A failed request returns the declared `EasitUnavailable` error with `reachable=false`, an endpoint, safe error text, and a hint when available.

See [Troubleshooting](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/troubleshooting.md), or return to the [action catalog](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions.md).
