Cloud endpoint

Retrieve Cloud Catalog

GET/environments/{environmentId}/cloud-catalog/

Path parameters

environmentId

Identifier used by the registered route.

Request body

none

This endpoint does not accept a request body.

cURL template

curl --fail-with-body \
  -H "Authorization: Bearer ${AKOFLOW_API_TOKEN}" \
  "${AKOFLOW_API_URL}/environments/{environmentId}/cloud-catalog/"

Replace the path identifiers with IDs from your instance.

200 OKapplication/json

Field shape inferred from Go types; inspect the returned JSON for actual values and optional fields.

{
  "provider": "string",
  "environmentId": "string",
  "project": "string",
  "region": "string",
  "source": "string",
  "machines": [
    {
      "provider": "string",
      "providerTypeId": "string",
      "region": "string",
      "zones": [
        "string"
      ],
      "family": "string",
      "vcpu": 0,
      "memoryMiB": 0,
      "architecture": "string",
      "gpuCount": 0,
      "gpuModel": "string",
      "supportsSpot": true,
      "available": true,
      "pricePerHour": 0,
      "pricePerMinute": 0,
      "priceCurrency": "string",
      "priceSource": "string",
      "providerMetadata": {}
    }
  ],
  "images": [
    {
      "provider": "string",
      "providerImageId": "string",
      "name": "string",
      "publisher": "string",
      "family": "string",
      "operatingSystem": "string",
      "architecture": "string",
      "source": "string",
      "status": "string",
      "minimumDiskGiB": 0,
      "deprecated": true,
      "providerMetadata": {}
    }
  ],
  "disks": [
    {
      "provider": "string",
      "providerTypeId": "string",
      "name": "string",
      "region": "string",
      "zones": [
        "string"
      ],
      "available": true,
      "pricePerGiBMonth": 0,
      "priceCurrency": "string",
      "priceSource": "string",
      "providerMetadata": {}
    }
  ],
  "warnings": [
    "string"
  ],
  "discoveredAt": "2026-01-01T00:00:00Z"
}

Handler-checked behavior

Returns the last synchronized catalog; this GET does not call the provider. Before the first successful refresh it returns 404. Read catalog warnings as well as machine, image, and disk choices; missing price data does not make a machine free.

Related guide

See the Cloud guide for related tasks and context.