---
title: "Provision and check the cluster connectivity in an environment"
method: POST
path: "/orgs/{orgId}/runtime/actions/check-connectivity"
tags: ["public", "RuntimeInfo"]
---

# Provision and check the cluster connectivity in an environment

`POST /orgs/{orgId}/runtime/actions/check-connectivity`

## Path parameters

- `orgId` string, required

## Request body

- ClusterConnectionCheckRequest — Detailed needed to test a Kubernetes cluster connection
  - `app_id` string, required — The application Id to test
  - `env_id` string, required — The environment Id to test
  - `env_type` string, required — The environment type to test
  - `expected_definitions` ResourceDefinitions[] — List of the definitions with their type that should be used by the resource graph nodes generated based on the context.
    - `type` string, required — Type of the resource provisioned by the definition
    - `id` string, required — The definition id

## Response `200`

The cluster connectivity test returned a result

- ClusterConnectionCheckResult — The result of testing the Kubernetes cluster connection
  - `success` boolean, required — Whether the test completed successfully
  - `resource_summaries` ClusterConnectionCheckResourceSummary[], required — A list of resources provisioned for the test
    - `type` string, required — The resource type that was provisioned
    - `class` string, required — The resource class that was provisioned
    - `res_id` string, required — The resource id that was provisioned
    - `gu_res_id` string, required — The globally unique resource identifier for the resource
    - `depends_on` string[], required — The list of globally unique resource identifiers that must be provisioned before this resource
    - `def_id` string, required — The resource definition that was used to provision the resource
    - `def_version_id` string, required — The resource definition version that was used to provision the resource
    - `driver_type` string, required — The driver type used by the resource definition, some driver types cannot be checked.
  - `conditions` ClusterConnectionCheckResultCondition[], required — A list of success or failure conditions contributing to the result
    - `type` string, required — The enum-name for the condition.
    - `status` 'True' | 'False' | 'Unknown', required — The status of the condition. True is the nominal value, False contributes to a failed result, Unknown is rare but indicates that a retry may be necessary or the condition could not be checked.
    - `message` string, required — A message explaining the cause of this condition.

---

[API](https://skmtc.net/humanitec/apis/humanitec-api.md) · [All operations](https://skmtc.net/humanitec/apis/humanitec-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humanitec/humanitec-api/revisions/e21ad140ec3c/schema)