List compute images

GET

/compute/images

Lists ready public OS images compatible with cloud or GPU VMs. Requires scope: vm.read.

Authentication

AuthorizationBearer

IBEE platform API token. Production tokens start with ibee_prod_key_; development tokens start with ibee_dev_key_. Use a token only with its matching gateway environment.

Query parameters

workspace_idstringRequiredformat: "^[1-9][0-9]*$">=1 character

The positive numeric workspace ID to scope this request to. Zero, negative, and non-numeric values are rejected.

vm_typeenumRequired

Allowed values:

site_idstringOptional>=1 character

Optional exact placement filter. Copy site_id from GET /compute/sites.

Response

Compute images returned successfully.

imageslist of objects

countinteger>=0

vm_typeenum

site_idstring or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

$	curl -G https://api.ibee.ai/v1/compute/images \
>	-H "Authorization: Bearer <token>" \
>	-d workspace_id=710995 \
>	-d vm_type=cloud

1	{
2	"images": [
3	{
4	"template_id": "string",
5	"name": "string",
6	"os_distro": "string",
7	"os_type": "linux",
8	"architecture": "string",
9	"size_bytes": 1,
10	"gpu_compatible": true,
11	"compatible_vm_types": [
12	"cloud"
13	],
14	"site_ids": [
15	"string"
16	],
17	"description": "string",
18	"distro_version": "string",
19	"image_format": "string"
20	}
21	],
22	"count": 1,
23	"vm_type": "cloud",
24	"site_id": "string"
25	}