Getting Solution History

1. Authentication

All further requests to the Solution Headless API are made using the end-user token.

2. Getting the List of Bundle Events (Runs)

Endpoint:

GET /bundle/events?expand=steps

Description:
Returns a list of events (runs) for all or a selected bundle. If you specify the expand=steps parameter, the response will include an array of steps for each event.

Request parameters:

bundleId (query, integer, optional) — filter by bundle ID
expand (query, string, optional) — if you specify steps, the response will include event steps

Request example:

curl --location 'https://api.albato.com/bundle/events?expand=steps' \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN'

Response example:

{
  "success": true,
  "data": [
    {
      "id": 3061464198,
      "bundleId": 269506,
      "status": 1,
      "event": 6,
      "dateCreated": "2025-05-19 17:58:18",
      "steps": [
        [
          {
            "id": 3944029339,
            "triggerActionId": 126003,
            "resultMessage": "Card created ID=682b47095c7d23c1c85bdb31",
            "status": 1,
            "error": null,
            "hasActiveRerun": false,
            "dateCreated": "2025-05-19 17:58:18",
            "behaviourType": "webhook",
            "token": "1747666698_v78_AN_z_1",
            "warning": null,
            "warningData": [],
            "stepLevel": 1
          }
        ],
        [
          {
            "id": 3944029340,
            "triggerActionId": 20002,
            "resultMessage": "Message sent: ID=7480575",
            "status": 1,
            "error": null,
            "hasActiveRerun": false,
            "dateCreated": "2025-05-19 17:58:18",
            "behaviourType": null,
            "token": "1747666698_v78_AN_z_3",
            "warning": null,
            "warningData": [],
            "stepLevel": 2
          }
        ]
      ]
    }
  ]
}

Endpoint for getting the list of bundle runs

3. Getting Step Details of an Event

Endpoint:

GET /bundle/events/steps/{step_id}

Description:
Returns detailed information about a specific step of an event (bundle run).

Request parameters:

step_id (path, integer, required) — event step ID

Request example:

curl --location 'https://api.albato.com/bundle/events/steps/987654321' \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN'

Response example:

{
  "success": true,
  "data": {
    "id": 123456789,
    "triggerActionId": 126003,
    "resultMessage": "Card created ID=123456095c7d23c1c85bdb31",
    "status": 1,
    "error": null,
    "hasActiveRerun": false,
    "dateCreated": "2025-05-19 17:58:18",
    "behaviourType": "webhook",
    "token": "987654321_v78_AN_z_1",
    "warning": null,
    "warningData": [],
    "stepLevel": 1
  }
}

Endpoint for getting bundle run step details