Skip to main content
GET
get-connection

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

The connection id.

Query Parameters

wait
boolean
timeout
integer
default:30
Required range: 1 <= x <= 60

Response

200 - application/json

Read a single connection by id or connection key, including its current status.

id
string
required

Internal database ID of the element. Assigned by the API; unique per element.

name
string
required
userId
string
required
tenantId
string
ownerName
string | null
type
enum<string>
Available options:
connector,
mcp,
pipedream
key
string
isTest
boolean
connected
boolean
hasDocs
boolean
docsCount
number
docsSummary
string
state
enum<string>
Available options:
BUILDING,
CLIENT_ACTION_REQUIRED,
CONFIGURATION_ERROR,
SETUP_FAILED,
READY,
DISCONNECTING
errors
object[]
requestError
object
integrationId
string
connectorId
string
externalAppId
string
connectorVersion
string
authOptionKey
string
createdAt
string
updatedAt
string
lastActiveAt
string
nextCredentialsRefreshAt
string
nextRetryTimestamp
string
retryAttempts
number
canTest
boolean
canRefreshCredentials
boolean
archivedAt
string
isDeactivated
boolean
meta
object
buildingAgentSessionId
string

Session ID for building the element via intent-based endpoints (create/update with intent). Present when state is BUILDING.

clientAction
object

Action the client must perform to advance this connection. Present if and only if state is CLIENT_ACTION_REQUIRED.

logoUri
string

Resolved app logo for this element (integration -> connector -> external app -> favicon).

input
any