> For clean Markdown of any page, append .md to the page URL. For a complete documentation index, see https://ibee.ai/docs/llms.txt (full text of every page: https://ibee.ai/docs/llms-full.txt). For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://ibee.ai/docs/_mcp/server. # Lists and paging > The response shape and paging parameters of every list operation, as the API serves them today. List operations do not share one envelope. Some answer a bare JSON array, others an object whose collection key is named after the resource (`items`, `snapshots`, `runs`, `stores`, …) with a `total` or `count`. Paging, where it exists, is page-numbered (`page` + `page_size` or `limit`), or continuation-token based for buckets. Nothing on this page changes in 0.7; it documents what the service returns so a client can be written against it. A common envelope for every list is planned for a later major version and will be announced in the changelog. Two things hold everywhere: * `workspace_id` is required on every list, as on every other call. * A list without paging parameters has no page controls: the service returns what it holds, subject to its own limits. Read the operation's description in the reference for any such limit. | Operation | Path | Response shape | Paging parameters | Other filters | | -------------------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------- | | `listSecretStores` | `GET /secret-store/stores` | object: `stores`, `total`, `page`, `limit` | `page`, `limit` | `include_archived` | | `listSecrets` | `GET /secret-store/stores/{store_id}/secrets` | object: `secrets`, `total`, `page`, `limit` | `page`, `limit` | `q` | | `listSecretVersions` | `GET /secret-store/secrets/{secret_id}/versions` | object: `secret_id`, `secret_name`, `current_version`, `oldest_version`, `versions` | none | | | `listSecretIdentities` | `GET /secret-store/stores/{store_id}/identities` | object: `identities`, `total` | none | | | `listSecretIdentityScopes` | `GET /secret-store/identities/{identity_id}/scopes` | object: `scopes`, `total` | none | | | `listBuckets` | `GET /object-storage/buckets` | object: `buckets`, `is_truncated`, `next_continuation_token` | `limit`, `continuation_token` | | | `listS3Credentials` | `GET /object-storage/credentials` | object: `credentials` | none | | | `listNetworkingSites` | `GET /networking/sites` | JSON array | none | | | `listVpcs` | `GET /networking/vpcs` | JSON array | none | `site_id` | | `listVpcSubnets` | `GET /networking/vpcs/{vpc_id}/subnets` | JSON array | none | | | `listVpcNodes` | `GET /networking/vpcs/{vpc_id}/nodes` | JSON array | none | | | `listNatGateways` | `GET /networking/vpcs/{vpc_id}/nat-gateways` | JSON array | none | | | `listNatPortForwardingRules` | `GET /networking/vpcs/{vpc_id}/nat-gateways/{nat_gateway_id}/port-forwarding-rules` | JSON array | none | | | `listReservedIps` | `GET /networking/reserved-ips` | JSON array | none | `site_id` | | `listFirewallGroups` | `GET /networking/firewall-groups` | JSON array | `limit`, `offset` | | | `listFirewallGroupAttachments` | `GET /networking/firewall-groups/{firewall_group_id}/attachments` | JSON array | `limit`, `skip` | | | `listLoadBalancers` | `GET /networking/load-balancers` | JSON array | `limit`, `skip` | `status`, `layer`, `protocol` | | `listComputeSites` | `GET /compute/sites` | object: `sites`, `count` | none | | | `listComputePlans` | `GET /compute/plans` | object: `plans`, `count`, `vm_type`, `site_id`, `currency`, `billing_interval` | none | `vm_type`, `site_id`, `currency`, `billing_interval`, `include_availability`, `os_type`, `requires_public_ip` | | `listComputeImages` | `GET /compute/images` | object: `images`, `count`, `vm_type`, `site_id` | none | `vm_type`, `site_id` | | `listSnapshotStoragePlans` | `GET /compute/plans/snapshot-storage` | object: `items`, `source`, `product_code`, `plan_id`, `plan_version`, `billing_interval`, `currency`, `site_filter_codes` | none | `site_id`, `currency`, `billing_interval` | | `listBackupStoragePlans` | `GET /compute/plans/backup-storage` | object: `items`, `source`, `product_code`, `plan_id`, `plan_version`, `billing_interval`, `currency`, `site_filter_codes` | none | `site_id`, `currency`, `billing_interval` | | `listCloudVms` | `GET /compute/cloud-vms` | JSON array | `limit`, `offset` | `search`, `sort_by`, `sort_direction`, `status`, `date` | | `listCloudVmEvents` | `GET /compute/cloud-vms/{vm_id}/events` | JSON array | `limit` | | | `listCloudVmSnapshots` | `GET /compute/cloud-vms/{vm_id}/snapshots` | object: `snapshots`, `total` | `limit`, `offset` | `search` | | `listAllCloudVmSnapshots` | `GET /compute/cloud-vm-snapshots` | object: `snapshots`, `total` | `limit`, `offset` | `search` | | `listCloudVmBackupRuns` | `GET /compute/cloud-vms/{vm_id}/backups/runs` | object: `runs`, `total` | `limit`, `offset` | `search` | | `listAllCloudVmBackupRuns` | `GET /compute/cloud-vm-backups/runs` | object: `runs`, `total` | `limit`, `offset` | `vm_id`, `status`, `search` | | `listGpuVms` | `GET /compute/gpu-vms` | JSON array | `limit`, `offset` | `search`, `sort_by`, `sort_direction` | | `listGpuVmEvents` | `GET /compute/gpu-vms/{vm_id}/events` | JSON array | `limit` | | | `listGpuVmSnapshots` | `GET /compute/gpu-vms/{vm_id}/snapshots` | object: `snapshots`, `total` | `limit`, `offset` | `search` | | `listAllGpuVmSnapshots` | `GET /compute/gpu-vm-snapshots` | object: `snapshots`, `total` | `limit`, `offset` | `search` | | `listGpuVmBackupRuns` | `GET /compute/gpu-vms/{vm_id}/backups/runs` | object: `runs`, `total` | `limit`, `offset` | `search` | | `listAllGpuVmBackupRuns` | `GET /compute/gpu-vm-backups/runs` | object: `runs`, `total` | `limit`, `offset` | `vm_id`, `status`, `search` | | `listBlockStoragePlans` | `GET /block-storage/plans` | object: `items`, `currency`, `billing_interval` | none | `site_id`, `currency`, `billing_interval` | | `listBlockVolumes` | `GET /block-storage/volumes` | JSON array | none | | | `listBlockVolumeOperations` | `GET /block-storage/volumes/{volume_id}/operations` | JSON array | none | | | `listCdnDistributions` | `GET /cdn/distributions` | object: `distributions`, `count` | none | | | `listCdnCustomDomains` | `GET /cdn/distributions/{distribution_id}/custom-domains` | object: `distribution_id`, `default_domain`, `custom_domains` | none | | | `listContainerRegistries` | `GET /container-registry/registries` | object: `items`, `total`, `page`, `page_size` | `page`, `page_size` | | | `listContainerRegistryAccessTokens` | `GET /container-registry/registries/{registry_id}/access-tokens` | JSON array | none | `include_revoked` | | `listContainerRegistryRepositories` | `GET /container-registry/registries/{registry_id}/repositories` | object: `items`, `total`, `page`, `page_size` | `page`, `page_size` | `search`, `sort` | | `listContainerRegistryArtifacts` | `GET /container-registry/registries/{registry_id}/artifacts` | object: `items`, `total`, `page`, `page_size` | `page`, `page_size` | `repository_name` | | `listContainerRegistryVulnerabilities` | `GET /container-registry/registries/{registry_id}/security/vulnerabilities` | object: `items`, `total`, `page`, `page_size` | `page`, `page_size` | `severity`, `cve_id`, `repository_name`, `digest`, `tag`, `package` | | `listContainerRegistrySboms` | `GET /container-registry/registries/{registry_id}/security/sboms` | object: `items`, `page_summary`, `total`, `page`, `page_size` | `page`, `page_size` | `repository_name` |