---
title: "Test CLI connection"
method: POST
path: "/sandbox-clis/test"
tags: ["Sandbox CLIs"]
---

# Test CLI connection

`POST /sandbox-clis/test`

Validate unsaved CLI credentials in a read-only ephemeral sandbox without persisting them.

## Request body

- object
  - `projectId` string, uuid — Project to test from. Required for organization-scoped keys; auto-filled from a project-scoped key when omitted.
  - `cliType` string, required — CLI type identifier.
  - `environmentVariables` object[], required — Unsaved credentials to validate in a readonly sandbox.
    - `key` string, required — Environment variable name (e.g. KUBECONFIG_CONTENTS).
    - `value` string, required — Secret value. Encrypted at rest; never returned by any API response.

## Response `200`

OK

- object
  - `status` 'success' | 'failed', required
  - `message` string, nullable, required
  - `stdout` string, required — Truncated command output with submitted credentials redacted.
  - `stderr` string, required — Truncated command errors with submitted credentials redacted.

---

[API](https://skmtc.dev/sazabi/apis/sazabi-public-api.md) · [All operations](https://skmtc.dev/sazabi/apis/sazabi-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sazabi/sazabi-public-api/revisions/1d12b71c735a/schema)