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.

DELETE/v1/connections/{connection_id}Disconnect.

user_id names whose it is.

Your API key, scope runtime or all. On the card: connect. Every call here is a checked sample.

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 2003 fields

object"connection"Always connection.

Type: "connection"

idstringThe disconnected connection's id.

Type: string

deletedtrueAlways true: Bash can no longer use the app for this user.

Type: true

TypeScript

await vestra.user('traveller-42').connect.remove('con_7hs');

Python

vestra.user("traveller-42").connect.remove("con_7hs")

CLI

vestra connect --remove con_7hs --user traveller-42

HTTP

# Get a sign-in link for one app. It is for one user: send them its url.curl "$VESTRA_BASE_URL/v1/connections" \  -H "Authorization: Bearer $VESTRA_API_KEY" \  -H "Content-Type: application/json" \  -d '{ "user_id": "traveller-42", "app": "gmail" }' # List their apps. You can also list the catalog your users may pick from.curl "$VESTRA_BASE_URL/v1/connections?user_id=traveller-42" \  -H "Authorization: Bearer $VESTRA_API_KEY" curl "$VESTRA_BASE_URL/v1/apps?search=calendar" \  -H "Authorization: Bearer $VESTRA_API_KEY" # Disconnect an app. user_id says whose connection it is.curl -X DELETE "$VESTRA_BASE_URL/v1/connections/con_7hs?user_id=traveller-42" \  -H "Authorization: Bearer $VESTRA_API_KEY"

MCP

{  "method": "tools/call",  "params": {    "name": "connect",    "arguments": { "user": "traveller-42", "app": "gmail" }  }}