Skip to main content
GET
/
api
/
v1
/
connections
/
{connection_id}
Get Connection
curl --request GET \
  --url https://api.example.com/api/v1/connections/{connection_id} \
  --header 'Authorization: Bearer <token>'
{
  "integration": "<string>",
  "integration_type": "connectors",
  "id": "<string>",
  "credential_id": "<string>",
  "user_id": "<string>",
  "workspace_id": "<string>",
  "created_by": "<string>",
  "status": "active",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "label": "<string>",
  "config": {}
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
X-Workspace-Id
string | null

The workspace ID

Path Parameters

​
connection_id
string
required

Query Parameters

​
include_credential
boolean
default:false

Include credential information

Response

Successful Response

Schema for reading connection data.

​
integration
string
required

Integration name (slack, github, etc.)

​
integration_type
enum<string>
required

Type of integration (connectors, mcp, tool, model, storage, api, custom)

Available options:
connectors,
mcp,
tool,
model,
custom,
storage,
api
​
id
string
required
​
credential_id
string
required
​
user_id
string | null
required
​
workspace_id
string
required
​
created_by
string
required
​
status
enum<string>
required
Available options:
active,
inactive,
testing,
error,
expired
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
label
string | null

Human-readable label for the connection

Maximum string length: 255
​
config
Config · object

Integration-specific configuration