---
id: upcloud-api
version: "2.9.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# upcloud-api — UpCloud API Client

License: permissive · Maintenance: active · Downloads: 78.4K/mo

## What it is and what it does

upcloud-api is an object-oriented Python wrapper around UpCloud's cloud infrastructure API. It provides classes for servers, storage, and networking resources, allowing you to create, modify, and destroy cloud infrastructure programmatically. The package handles authentication, request marshalling, and response parsing, so you work with Python objects rather than raw HTTP calls.

The client is designed for both direct scripting and integration into larger automation tools like Ansible. It includes convenience methods that combine multiple API calls (e.g., stop-and-destroy) and helper functions for common tasks like retrieving public IPs or converting resources to dictionaries. The documentation recommends testing thoroughly before production use and suggests using a separate UpCloud account for development.

Use it for:

- Automate server provisioning and teardown in CI/CD pipelines or infrastructure-as-code workflows.
- Build custom dashboards or monitoring tools that query server state and resource usage across your UpCloud account.
- Implement dynamic scaling logic that creates or destroys servers based on application demand.
- Clone existing server configurations or storage volumes to quickly spin up new environments.
- Manage server lifecycle operations (start, stop, upgrade, destroy) from Python scripts or scheduled tasks.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Object-oriented Python client for UpCloud's cloud infrastructure API, enabling programmatic management of servers, storage, and networking resources.

Yes. The package is actively maintained, has low install friction, carries a permissive MIT license, and integrates cleanly with a single well-known dependency. It is suitable for anyone managing UpCloud infrastructure programmatically. Test your use cases thoroughly before production deployment, as the documentation emphasizes, and consider using a separate dev account initially.

## Install

pip install upcloud-api
uv add upcloud-api
poetry add upcloud-api

## Installing upcloud-api

Before you install: Low friction install with a single dependency (requests). Actively maintained with recent commits and a release within the past year. Supports modern Python versions (3.9–3.13 and PyPy3).

License in practice: MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute this package freely provided you include the license notice.

Quickstart:

pip install upcloud-api

from upcloud_api import CloudManager, Credentials

credentials = Credentials.parse()
manager = CloudManager(**credentials.dict)
manager.get_account()

Requires valid UpCloud API credentials (username and password or environment variables); the package does not authenticate without them.

Verify before relying:

- Whether the convenience functions that combine multiple API endpoints cover the most common workflows or require custom orchestration.
- Performance characteristics and rate-limiting behavior when managing large numbers of servers or storage resources.
- Completeness of API coverage relative to the current UpCloud API specification version.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 78.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

upcloud api client, cloud server management python, infrastructure as code upcloud, vm provisioning api, cloud resource automation, upcloud python sdk, server lifecycle management, cloud-infrastructure, api-client, infrastructure-automation

[View on SkillFed](https://skillfed.io/packages/upcloud-api) · [View on PyPI](https://pypi.org/project/upcloud-api/)