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):tenantorspace:<space id>
Example 200 answer:
{
"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
curl -X GET 'https://api.mbcom.cloud/api/desk/v1/items/string/actions' \
-H "Authorization: Bearer $ACCESS_TOKEN"