Execute automations

This guide explains how to manually execute an automation using the STACKIT Automation Service API or the STACKIT Portal. While automations can run automatically based on schedules, you can also trigger them manually when needed.

Prerequisites

• Swagger API definition for the STACKIT Automation Service API.
• Automation Service has been enabled
• An existing automation

Execute an automation manually

API

To execute an automation manually, you need to provide the following information:

• projectId
• regionId
• automationId

Use the following POST request to trigger manual execution:

POST https://automation-service.api.stackit.cloud/v1/projects/{projectId}/regions/{regionId}/services/volumes/automations/{automationId}/executions

1. Get your automation ID: Use the automation ID from when you created the automation, or list your automations to find the correct ID.

2. Send the POST request: Execute the API call to trigger the automation.

3. Store the execution ID: The response will include an executionId that you can use to check the results.

Response example

{
  "automation": {
    "config": {
      "description": "Creates daily recovery points (snapshots and backups) for all volumes with specified label",
      "id": "eb62d5e5-fc29-4203-9fe7-fe809ae0aefc",
      "input": {
        "inheritVolumeLabels": false,
        "kind": "VolumeRecoveryPointManagement",
        "recoveryPointLabels": {
          "key1": "value1",
          "key2": "value2"
        },
        "snapshotRetentionPolicy": {
          "kind": "count",
          "value": 2
        },
        "backupRetentionPolicies": [
          {
            "kind": "daily",
            "retentionPeriod": 14
          }
        ],
        "volumeLabelSelector": "myLabelkey1=myLabelValue,myLabelKey2=myOtherLabelValue"
      },
      "name": "My Daily Volume Recovery Point Creation Automation",
      "output": {
        "steps": [
          {
            "name": "Get Volumes IDs with Label",
            "result": {
              "kind": "GetVolumeIDsResult",
              "volumeIDs": []
            }
          },
          {
            "name": "Create Snapshots for Volume IDs",
            "result": {
              "createdSnapshotIDs": [],
              "kind": "CreateRecoveryPointsResult"
            }
          }
        ]
      },
      "templateId": "62c5178a-87fb-437f-88c8-c6f26b3ee4f6",
      "triggers": {
        "schedule": {
          "rrule": "DTSTART;TZID=Europe/Sofia:20200803T023000\nRRULE:FREQ=DAILY;INTERVAL=1"
        }
      }
    },
    "output": {
      "steps": [
        {
          "name": "Get Volumes IDs with Label",
          "result": {
            "kind": "GetVolumeIDsResult",
            "volumeIDs": []
          },
          "status": "PENDING"
        },
        {
          "name": "Create Snapshots for Volume IDs",
          "result": {
            "createdSnapshotIDs": [],
            "kind": "CreateRecoveryPointsResult"
          },
          "status": "PENDING"
        }
      ]
    }
  },
  "createTime": "2026-09-24T17:32:28Z",
  "id": "1263fd13-be86-4fe4-a2aa-ef5526c607cd",
  "status": "PENDING"
}

API Reference: ExecuteAutomation.

STACKIT Portal

To execute an automation manually follow the steps below:

1. On the project overview navigate to Storage —> Disk Volumes —> Automations to display all created automations.
2. Choose the automation you want to execute manually and click on the vertical dots on the right side of this automation.
3. In the popup window click on Execute now.
4. A confirmation window will appear, click on Execute.
5. You are automatically redirected to the run history list view of this automation.

STACKIT CLI

To trigger a manual execution of an existing automation using STACKIT CLI:

stackit beta volume automation execute \
  --project-id "your-project-id" \
  --automation-id "eb62d5e5-fc29-4203-9fe7-fe809ae0aefc"

Terraform

Automations managed via Terraform are automatically executed according to their defined schedule. To trigger manual executions programmatically or outside of schedules, use the STACKIT CLI or standard API endpoints.

List automation executions

API

To see all executions for a specific automation, use this GET request:

GET https://automation-service.api.stackit.cloud/v1/projects/{projectId}/regions/{regionId}/services/volumes/automations/{automationId}/executions

This will return a list of all executions for the automation, including their status and timestamps.

STACKIT Portal

To see all executions for a specific automation in the STACKIT Portal follow the steps below:

1. On the project overview navigate to Storage —> Disk Volumes —> Automations to display all created automations.
2. Choose the automation you want to check and click on it.
3. Click on Run History on the left side to display all runs of this automation and their execution status.
4. For more information, click on a specific run to view available details in the right-hand panel, including step status.

STACKIT CLI

To list all executions for a specific volume automation using the STACKIT CLI, run:

stackit beta volume automation execution list \
  --project-id "your-project-id" \
  --automation-id "eb62d5e5-fc29-4203-9fe7-fe809ae0aefc"

This will output a list of recent execution runs along with their respective IDs, start/completion timestamps, and statuses.

Terraform

Terraform manages the configuration state of your automations rather than execution history logs. To list and inspect execution runs, use the STACKIT CLI (stackit beta volume automation execution list) or the STACKIT Portal.

Once executed, you can check the results of the automation execution. See Check automation results for details.