Resolve a free size

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

Path Parameters

offering_id string required

aitronos. A bring-your-own offering is refused: order one of its sizes instead.

Query Parameters

organization_id string optional

The organization to act in. Defaults to your current organization. You must be an active member of it, or the request is refused with 403 ORGANIZATION_ACCESS_DENIED.

Headers

X-Organization-Id string optional

The same as organization_id, as a header. When both are sent, the query parameter wins.

Body Parameters

location_id string required

A location id from the options, e.g. eu-central.

vcpu integer required

The vCPUs wanted, 1 to 4096.

memory_gb integer required

The memory wanted in GB, 1 to 65536.

Unknown fields are refused.

Returns

catalog_version string — send it back inside the quote of the create.

currency string — CHF.

location_id, vcpu, memory_gb — the choice, as asked.

machine_type_id string or null — the server to create, as a machine_types id of the options (a size's id, e.g. std-16, when a size has exactly that vCPU and memory); null when no server in the location has both.

note string or null — a sentence to show: why a larger server was chosen ("No server in Germany has exactly 16 vCPU and 192 GB, so this is the cheapest one with at least that much."), or the largest server there when none fits ("The largest server in Germany has 48 vCPU and 192 GB."); null for an exact match.

machine_type object or null — the chosen server in the shape of an options sizes entry, priced in this location only: prices[0] carries hourly, monthly_cap, summary, option_label, button_label and can_create.

alternatives array — only when nothing fits here: the other locations where the choice fits, each {location_id, size_id, hourly, currency}; empty otherwise.

Errors

curl -X POST "https://api.aitronos.com/v1/forge/compute/offerings/aitronos/options/resolve" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"location_id": "eu-central", "vcpu": 16, "memory_gb": 192}'

Response:

{
  "catalog_version": "fc-3b8e1f0a9c42",
  "currency": "CHF",
  "location_id": "eu-central",
  "vcpu": 16,
  "memory_gb": 192,
  "machine_type_id": "ded-x86-48c-192g",
  "note": "No server in Germany has exactly 16 vCPU and 192 GB, so this is the cheapest one with at least that much.",
  "machine_type": {
    "id": "ded-x86-48c-192g",
    "label": "48 vCPU · 192 GB",
    "vcpu": 48,
    "memory_gb": 192,
    "disk_gb": 960,
    "arch": "x86_64",
    "dedicated_cpu": true,
    "order": 0,
    "prices": [
      {
        "location_id": "eu-central",
        "hourly": "2.58",
        "monthly_cap": "1607.04",
        "includes_vat": false,
        "available": true,
        "price_verified": true,
        "summary": "48 vCPU · 192 GB · Germany",
        "option_label": "48 vCPU · 192 GB · CHF 2.58/h",
        "button_label": "Create · 48 vCPU · 192 GB · Germany · CHF 2.58/h, at most CHF 1,607.04/month",
        "can_create": true
      }
    ]
  },
  "alternatives": []
}