---
url: https://ibee.ai/docs/2026-10-19-public-api-contract-0-4-0
last_updated: 2026-10-19
---

> 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.

# October 19, 2026

## Public API reference 0.4.0

The API reference now describes what the API already accepts and returns. No endpoint changed behaviour.

* **VM delete** documents its optional body. `public_ip_action` (`reserve` or `release`) is required when the VM has an automatically assigned public IP, and `reserve` also needs `reserved_ip_billing_catalog`.
* **VM create** documents the launch network options `vpc_id`, `subnet_id`, `network_connectivity`, `vpc_attachment_mode` and `reserved_public_ip_id`, and inline `ssh_keys`.
* **VM and firewall group lists** take `limit` (default 10, at most 100) and `offset`.
* **Snapshot create, backup enable, manual backup runs and volume attach** require `billing_catalog`.
* **VPC create** accepts `connectivity_type: private`.
* **Billing eligibility** accepts `resource_type`, `quantity`, `size_gb` and `operation`, and returns `resource_limits` and, when a plan limit refuses, `resource_limit_key`, `resource_limit` and `resource_usage`.
* **Secret Store** `GET /secret-store/identities/{identity_id}/access` is listed under `secret-store.write`, the scope the gateway already requires, because each call mints a new credential.
* **Errors** share one documented body (`error`, `required_scope`, `billing_reason`, `billing_sku_code`, `admission_context_id`), and operations now list the 402, 423, 429 and 503 responses they can return.