Skip to main content
POST
Start a new test of a Connection.
Scope: workspace:connections:write. See API Tokens.

Authorizations

Authorization
string
header
required

CloudThinker token: a personal access token ct_pat_… (fine-grained scopes, created in Settings) or an OAuth access token ct_oat_… (1 hour, from the OAuth flow). Send Authorization: Bearer <token>. Scopes have the form module:resource:read|write; write includes read.

Headers

Idempotency-Key
string
required

Unique per logical write. A retry with the same key and body returns the first result.

Required string length: 1 - 255

Path Parameters

workspace_id
string<uuid>
required

Workspace to act in. Every call names it.

connection_id
string<uuid>
required

Connection id.

Response

Created

Latest connection test.

connection_id
string<uuid>
required
phase
enum<string>
required
Available options:
queued,
starting_sandbox,
running_script,
succeeded,
failed,
timeout,
cancelled
started_at
string<date-time> | null
required
elapsed_ms
integer | null
required
last_error
string | null
required
failure_kind
enum<string> | null
required
Available options:
auth_failed,
host_key_mismatch,
unreachable,
remote_exit_code