Cloud endpoint

Refresh Cloud Catalog

POST/environments/{environmentId}/cloud-catalog/refresh/

Path parameters

environmentId

Identifier used by the registered route.

Request body

none

This endpoint does not accept a request body.

Query parameters

async

Set to `true` to start cloud catalog discovery in the background and return `202 Accepted` immediately. Repeat requests while it is running do not start another discovery.

cURL template

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

Replace the path identifiers with IDs from your instance.

202 Acceptedapplication/json

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

{
  "status": "string",
  "environmentId": "string"
}

200 OK

Handler-checked behavior

Discovers the catalog using the saved cloud connection. Without async, returns the catalog with 200 OK or an error with 422. With async=true, returns 202 Accepted immediately and runs discovery in the background. Repeated async requests for the same environment while discovery is active do not start another job. GET /environments/{environmentId}/cloud-catalog/ returns 404 until a catalog has been synchronized. This is not a VM provisioning request.

Related guide

See the Cloud guide for related tasks and context.