Skip to main content

At a glance

Credentials

Set these per environment. See Connect an integration.

Setup

  1. Get a STACKIT account and project: STACKIT is a B2B cloud by Schwarz Digital - request an organization at https://www.stackit.de, then create a project in the STACKIT Portal (https://portal.stackit.cloud).
  2. Create a service account with a key: In the Portal, open your project > Service Accounts, create one, assign it a role (e.g. reader), and create a service account key (key flow). The legacy static token flow was removed on 17 December 2025.
  3. Obtain a short-lived access token: Exchange a self-signed JWT (signed with the key’s private RSA key) at the service account token endpoint, or simply run the STACKIT CLI: ‘stackit auth activate-service-account —service-account-key-path key.json’ and export the resulting access token.
  4. Set the environment variable: Put the access token into your .env as STACKIT_SERVICE_ACCOUNT_TOKEN.
  5. Verify access: Run List Projects with member set to the service account’s email, then List Servers for a returned projectId in your region (e.g. eu01).
  • Access tokens from the key flow are short-lived (refresh roughly every 10 minutes) - automate token renewal for long-running agents
  • List Projects requires at least one filter: containerParentId (organization/folder) or member (email)
  • The IaaS API v2 is the stable release; v1 is deprecated and will be removed after 1 March 2027
  • IaaS URLs are region-scoped via the {region} path segment, e.g. eu01
Provider API reference: https://docs.stackit.cloud/developer-tools/stackit-api/

Tools

Example prompts

  • List my STACKIT projects, then list the servers in the project and region I name, with status and machine type.
  • Show me the STACKIT machine types available in my project and region and recommend one for a small web service.