## The automations an agent can start on the ticket (its „Aktionen“) (desk:read)

`GET /api/desk/v1/items/{ref}/actions`

Module: Desk · operationId: `listItemActions` · Tag: Automation · Auth: access token (`Authorization: Bearer <accessToken>`)

The enabled automations of the tenant and of the ticket's space with a manual trigger whose `filter` holds for the ticket (`trigger.data` is the ticket's event payload). Empty for callers below the agent role and for the tombstone of a converted ticket.

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `ref` | path | string | yes | Item id or number |

### Responses

- **200** Automations (`application/json`)
- **404** Error (`application/json`)

Fields of the 200 answer:

- `items` (array of object, required)
  - `id` (string (uuid), required)
  - `key` (string, required)
  - `name` (string, required)
  - `scope` (string, required): `tenant` or `space:<space id>`

Example 200 answer:

```json
{
  "items": [
    {
      "id": "8c5d6e7f-9a0b-4c1d-8e3f-5a6b7c8d9e05",
      "key": "vor-ort-einsatz-planen",
      "name": "Vor-Ort-Einsatz planen",
      "scope": "space:9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c00"
    }
  ]
}
```

### Example request

```bash
curl -X GET 'https://api.mbcom.cloud/api/desk/v1/items/string/actions' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
