Every sample on every page follows this. Change it any time.

Get a test key
BashBrainTeammatesPricingDevelopersGet a test key

Connected apps

The apps each user connects through a sign-in link, and the apps they may choose from.

Send Authorization: Bearer vk_test_... on every call. Every route of Connected apps.

GET/v1/connections/{connection_id}One connection's status.

user_id names whose it is.

Your API key, scope runtime or all. On the card: connect. Over HTTP it is made from the contract: fill in each {…} and every value.

Request2 fields

Path

connection_idstringrequiredThe connected app's id (con_...).
Type
string

Query

user_idstringWhose Bash: your id for the user. Absent: your company's own Bash.
Type
string
Answers 2007 fields
object"connection"Always connection.
Type
"connection"
idstringThe connection's id.
Example
con_8f2k
user_idstring | nullYour id for the user; null for your company's own Bash.
Type
string | null
appstringThe app, by its slug.
Example
gmail
status"active" | "pending" | "initializing" | "expired" | "revoked" | "inactive" | "failed"active: Bash can use it. pending or initializing: the sign-in is not finished. expired, revoked, inactive or failed: it no longer works, and the user connects it again.
Type
"active" | "pending" | "initializing" | "expired" | "revoked" | "inactive" | "failed"
labelstring | nullThe account's label, usually its email; null when the app gives none.
Type
string | null
created_atstringWhen it was connected, as an ISO 8601 date and time in UTC.
Type
string
TypeScript
const connection = await vestra.user('traveller-42').connect.get('con_7hs');
Python
connection = vestra.user("traveller-42").connect.get("con_7hs")
HTTP

No sample in your language for this route, so here it is over HTTP.

curl "$VESTRA_BASE_URL/v1/connections/{connection_id}" \  -H "Authorization: Bearer $VESTRA_API_KEY"