keboola/sandboxes-service-api-client

Keboola Sandboxes Service API client

1.5.0 2025-11-28 15:03 UTC

Requires

• php: ^8.2
• guzzlehttp/guzzle: ^7.8
• monolog/monolog: ^2.0|^3.0
• webmozart/assert: ^1.11

Requires (Dev)

• infection/infection: ^0.27.9
• keboola/coding-standard: ^15.0
• phpstan/phpstan: ^1.10
• phpstan/phpstan-phpunit: ^1.3
• phpstan/phpstan-webmozart-assert: ^1.2
• sempro/phpunit-pretty-print: ^1.4
• symfony/http-client: ^6.4|^7.0

MIT

• Keboola

README

Installation

composer require keboola/sandboxes-service-api-client

Usage

Sandboxes API

use Keboola\SandboxesServiceApiClient\Sandboxes\SandboxesApiClient;
use Keboola\SandboxesServiceApiClient\ApiClientConfiguration;

$client = new SandboxesApiClient(new ApiClientConfiguration(
    baseUrl: 'https://data-science.keboola.com',
    storageToken: '{storage-api-token}',
    userAgent: 'My App',
));

$result = $client->createSandbox([
    'componentId' => 'keboola.data-apps',
    'configurationId' => '123',
    'configurationVersion' => '4',
    'type' => 'streamlit',
]);

Apps API

use Keboola\SandboxesServiceApiClient\Apps\AppsApiClient;
use Keboola\SandboxesServiceApiClient\ApiClientConfiguration;

$client = new AppsApiClient(new ApiClientConfiguration(
    baseUrl: 'https://data-apps.keboola.com',
    storageToken: '{storage-api-token}',
    userAgent: 'My App',
));

// List all apps
$apps = $client->listApps();

// Get specific app
$app = $client->getApp('app-id');

// Update app state
$client->patchApp('app-id', [
    'desiredState' => 'running',
    'restartIfRunning' => true,
]);

License

MIT licensed, see LICENSE file.