ConnectCloud Developers

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:

{
  "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"

View as Markdown · Interactive reference · OpenAPI