> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ankra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# UpCloud API Credentials

> Store UpCloud API access in Ankra to provision and manage UpCloud clusters and UKS.

UpCloud API credentials store the API access for an UpCloud subaccount, used to provision and manage self-managed [UpCloud clusters](/guides/upcloud-clusters) and [UpCloud Managed Kubernetes (UKS)](/guides/uks-clusters). The credential is validated against the UpCloud API on creation.

## Creating an UpCloud API Credential

<Steps>
  <Step title="Enable API access in UpCloud">
    1. Log in to the [UpCloud Control Panel](https://hub.upcloud.com)
    2. Go to **People** and create (or open) a subaccount with **API connections** allowed
    3. Note the subaccount's API credentials
  </Step>

  <Step title="Add to Ankra (UI)">
    Go to **Credentials** → **Add** → **UpCloud**, enter a name, and paste the API credential.
  </Step>

  <Step title="Or via CLI">
    ```bash theme={null}
    ankra credentials upcloud create --name my-upcloud
    # You will be securely prompted for the API token
    ```
  </Step>
</Steps>

For self-managed UpCloud clusters you also need an [SSH key credential](/platform/credentials/ssh-key) - create one with `ankra credentials upcloud ssh-key create --name my-key --generate`.

## Listing UpCloud Credentials

<CodeGroup>
  ```bash CLI theme={null}
  ankra credentials upcloud list
  ```

  ```bash cURL theme={null}
  curl https://platform.ankra.app/api/v1/credentials/upcloud \
    -H "Authorization: Bearer $ANKRA_API_TOKEN"
  ```
</CodeGroup>