Agent API

CLI&Open CLOUD agent checkout workflow

Agents can discover products, quote deterministic pricing, create a pending payment order from customer billing data, and poll the returned signed status URL until payment and service readiness are complete.

Workflow

Recommended sequence

  1. Discover products with GET /api/products or GET /api/products/{product_id}.
  2. Quote with POST /api/checkout/quote. Check configuration_normalized and configuration_warnings; invalid limits are defaulted down instead of clamped up.
  3. If the customer agrees and billing fields are known, create a pending order with POST /api/order and an Idempotency-Key.
  4. Poll the returned status_url. Treat it like a bearer token and do not publish it.
  5. When payment is confirmed asynchronously, the status changes from Pending to Success. Continue polling until services become ready.
Required order fields

Billing is required before order creation

If the agent only has an email address, it should ask the customer for billing details before creating the order. The API intentionally returns validation errors instead of guessing billing data.

{
  "customer_email": "customer@example.com",
  "billing_name": "Customer Name",
  "billing_street": "Cloud Street 1",
  "billing_city": "Bratislava",
  "billing_postal_code": "81101",
  "billing_country": "SK",
  "items": [
    {"product_id": "managed-vps", "quantity": 1}
  ]
}
Machine docs

Discovery endpoints

OpenAPI · Agent policy · AI map · llms.txt · MCP-style tools