Skip to main content
GET
Get one Connection: status, status message, tools, latest test.
Scope: workspace:connections:read. 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.

Path Parameters

workspace_id
string<uuid>
required

Workspace to act in. Every call names it.

connection_id
string<uuid>
required

Connection id.

Response

OK

One installed Connection with its latest test.

id
string<uuid>
required
kind
enum<string>
required
Available options:
builtin,
mcp
name
string
required
prefix
string
required
alias
string | null
required
description
string | null
required
category
enum<string> | null
required
Available options:
cloud_platform,
infrastructure_automation,
container_platform,
app_platform,
database,
ai_engineering,
monitoring,
log_analytics,
incident_management,
software_delivery,
security_identity,
compliance,
soc,
work_management,
product_insight,
data_streaming
environment
enum<string> | null
required
Available options:
production,
staging,
development
status
enum<string>
required
Available options:
connected,
testing,
disconnecting,
error
status_message
string
required
cost_capable
boolean
required

True when Optimize can read cost data through it.

tools
ConnectionTool · object[]
required
locations
ConnectionLocation · object[]
required

Saved URL, host, region and tenant values. Never credentials.

updated_at
string<date-time> | null
required
test
ConnectionTest · object | null
required

Latest test. Null when never tested.

demo
boolean
required

True when it runs on CloudThinker's shared demo environment.