This approach ensures the SDK stays closely aligned with the platform’s evolving API while providing a clean,
developer-friendly interface, making it easier to maintain and extend over time.
## Staying up to date
Every day, a [GitHub workflow](https://github.com/upsun/upsun-sdk-php/blob/main/.github/workflows/check_api.yaml)
checks the official OpenAPI spec against our local version.
If it finds any differences, it automatically opens a Pull Request and notifies our Advocacy team to keep the SDK
aligned with the live API.
## Usage examples
To give you an overview of what you can do with this Upsun SDK PHP, here are some examples below:
### Installation
Install the Upsun SDK PHP via Composer:
```bash {filename="Terminal"} theme={null}
composer require upsun/upsun-sdk-php
```
Then include Composer’s autoloader in your PHP application:
```php {filename="test-sdk.php",base_url="https://github.com/upsun/upsun-sdk-php/blob/main/"} theme={null}
require __DIR__ . '/vendor/autoload.php';
```
### Authentication
You’ll need an [Upsun API token](https://docs.upsun.com/administration/cli/api-tokens.html) to use the SDK.\
Store it securely, for example in an environment variable:
```php {filename="test-sdk.php",base_url="https://github.com/upsun/upsun-sdk-php/blob/main/"} theme={null}
use Upsun\UpsunConfig;
use Upsun\UpsunClient;
$config = new UpsunConfig(apiToken: getenv('UPSUN_API_TOKEN'));
$client = new UpsunClient($config);
```
### List organizations
```php {filename="test-sdk.php",base_url="https://github.com/upsun/upsun-sdk-php/blob/main/"} theme={null}
$organizations = $client->organizations->list();
```
### List projects in an organization
```php {filename="test-sdk.php",base_url="https://github.com/upsun/upsun-sdk-php/blob/main/"} theme={null}
$projects = $client->organizations->listProjects('