Environments endpoint

Discover Environment Connection

POST/environment-connections/{connectionId}/discover/

Path parameters

connectionId

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}" \
  -X POST \
  "${AKOFLOW_API_URL}/environment-connections/{connectionId}/discover/"

Replace the path identifiers with IDs from your instance.

200 OKapplication/json

Handler-checked response shape; values and optional fields vary.

{
  "snapshots": []
}

Handler-checked behavior

Discovers through a saved connection and returns a snapshots array. The connection needs a configured discovery driver and bound resources; missing prerequisites return 422. A successful request records observed inventory but does not reserve a scheduler allocation or guarantee that every site resource was found.

Related guide

See the Environments guide for related tasks and context.