Obtain Creodias Managed Kubernetes API token

Note

Managed Kubernetes is available as an Early Access preview — reach out to sales@creodias.eu to learn how you can take part.

To interact with Creodias Managed Kubernetes programmatically, you need an API token. It grants secure access to the Creodias Managed Kubernetes API and is typically used in conjunction with external tools such as

With the API token for Creodias Managed Kubernetes, it will be possible to programmatically initiate cluster lifecycle operations such as nodepools creation and scaling.

What We Are Going to Cover

Prerequisites

No. 1 Hosting

You need a CREODIAS hosting account https://new.cloudferro.com/ as well as access to the Creodias Managed Kubernetes service.

Generate token from GUI

  1. Show Tokens option on screen

To get to the tokens view in Creodias Managed Kubernetes, find button Tokens in the left side bar:

../_images/get_to_token_button.png

If the browser window or device screen is narrow, first click on the hamburger icon in the upper left corner.

  1. Go to Tokens view

Click on Tokens button to bring tokens view in Creodias Managed Kubernetes. The following screenshot represents the situation in which there are no tokens created yet:

../_images/1password-image-3.png

  1. Click Create token, then choose validity, permissions and add optional info.

../_images/1password-image-349.png

  1. Create the token

Click Create token in that form.

../_images/create_token_234.png

As a result, the token is generated. Make sure to note it down and store it securely, because it will not be shown again.

The list of tokens will now contain an additional entry:

../_images/1password-image-345.png

Click on the eye icon in the Roles column to see the activated roles for the specific token:

../_images/1password-image-346.png

This list will reflect the options you chose while creating the token.

Note

The image above depicts the API operations permitted by the token, while other operations may remain inaccessible.

Access Creodias Managed Kubernetes API using the token

Work with API documentation

The detailed documentation how to use API is presented in the Swagger documentation:

https://managed-kubernetes.creodias.eu/swagger

../_images/cloudferr-managed-kubernetes.png

Obtain cluster ID

API access allows for utilizing a series of options for interacting with Creodias Managed Kubernetes, which is described in detail in the API doc from above. From a practical standpoint a large part of such operations will be in the context of a given Kubernetes cluster. We will provide a brief recap of how to access the cluster ID and use it in the API call as demonstrated later.

To obtain the cluster ID, click on Home, select the region and see the list of clusters on screen. Select the one that you want to work with, for instance, let it be cluster called networktest. Clicking on its name will display cluster data, including the Cluster ID.

../_images/1password-image-347.png

Example: list cluster parameter

The following example lists basic parameters in the specified cluster.

Replace XXXX—clusterID—XXXX with your cluster ID and YYYY—token—YYYY with your token:

curl -X GET "https://managed-kubernetes.creodias.eu/api/v1/api/v1/cluster/XXXX---clusterID---XXXX" \
  -H "Authorization: Token YYYY---token---YYYY" \
  -H "Content-Type: application/json" \
  -k

The -k option is used if the certificate is self-signed. If possible, configure trusted certificates instead of relying on -k.

Sample response:

{
"id": "fea4bff1-2720-4591-8215-9e1ce90c4d3a",
"created_at": "2025-09-03T09:10:58.833730Z",
"updated_at": "2025-09-03T09:17:47.887976Z",
"name": "networktest",
"organisation_id": "7b5d9213-bbbb-4693-acd7-63787e45a111",
"join_token_expires_at": "0001-01-01T00:00:00Z",
"status": "Running",
"control_plane": {
  "custom": {
   "size": 1,
   "machine_spec": {
    "id": "b003e1cf-fd40-4ad1-cccc-cc20c2ddd555",
    "created_at": "2025-02-05T11:14:35Z",
    "updated_at": "2025-02-05T11:14:35Z",
    "name": "eo2a.large",
    "provider": "CloudFerro",
    "region": "WAW4-1",
    "cpu": 2,
    "memory": "7632",
    "local_disk_size": "32",
    "is_active": true,
    "tags": [
     "control-plane",
     "worker"
    ]
   },
   "name": "meek-opossum"
  }
},
"errors": [],
"version": {
  "id": "d70785b2-4b01-4444-8103-2c37479fbeee",
  "created_at": "2025-08-11T07:15:57.771816Z",
  "updated_at": "2025-08-11T07:15:57.771816Z",
  "version": "1.32.6",
  "eol": "2025-12-27T23:00:00Z",
  "info": "",
  "is_active": true
},
"metadata": {
  "openstack_project_id": "74140b908ef142e18ced9b7046f7cd91"
}
}

What To Do Next

With your API token, you can now securely interact with Creodias Managed Kubernetes from the command line or automation tools. Use it to connect CI/CD pipelines, manage workloads, or monitor resources programmatically.

To explore available operations, open the Creodias Managed Kubernetes API documentation for your environment at https://managed-kubernetes.creodias.eu/swagger.