Introduction

Introduction

The IBEE Solutions API gives you programmatic access to your infrastructure. You can manage virtual machines, object storage buckets, secrets, and more — all from your own code or automation tools.

Base URL

All API requests use the following base URL:

https://api.ibee.ai/v1

Workspace scoping

Every API request must include a workspace_id query parameter. This scopes the request to a specific workspace within your organization.

$curl https://api.ibee.ai/v1/object-storage/buckets?workspace_id=907479 \
>  -H "Authorization: Bearer YOUR_API_TOKEN"

Workspaces isolate resources so that production, staging, and development environments stay separate. You choose which workspaces a token can access when you create it.

Available resources

ResourceDescription
Secret StoreCreate stores, manage secrets, and retrieve values.
Object StorageCreate and manage S3-compatible storage buckets.
Cloud VMsDeploy and manage cloud virtual machines.
GPU VMsDeploy and manage GPU-accelerated virtual machines for AI/ML workloads.

Response format

All responses are JSON. Successful responses return the resource directly. Errors return a JSON object with a detail field:

1{
2  "detail": "The requested resource was not found."
3}

Async operations

Some operations — creating, deleting, starting, stopping, or rebooting virtual machines — are asynchronous. These endpoints return 202 Accepted with an operation_id you can poll:

1{
2  "operation_id": "op_123",
3  "vm_id": "vm_abc123",
4  "status": "accepted",
5  "submitted_at": "2026-07-01T12:00:00Z"
6}

Use the Get operation status endpoint to check progress.

Idempotency

Write operations (create, delete, power actions) require an X-Idempotency-Key header. If a request fails due to a network issue, you can safely retry with the same key — the server will not create duplicate resources.

$curl -X POST https://api.ibee.ai/v1/compute/cloud-vms?workspace_id=907479 \
>  -H "Authorization: Bearer YOUR_API_TOKEN" \
>  -H "X-Idempotency-Key: unique-request-id-123" \
>  -H "Content-Type: application/json" \
>  -d '{"name": "web-server-01", "os_distro": "ubuntu", "os_type": "linux", "cpu": 2, "ram_mb": 4096}'

Next steps