Account

Set a connection's team binding

Changed on

Binds an OAuth connection to a team and optional default folder. Send team_id: null (or omit it) to move the connection back to the personal account. A connected app can only change its own binding; an app session must pass client_id in the body. API keys have no connection and get 400. Returns the stored binding.

put/me/connection

Request

  • Base URL: https://api.varg.ai/v2
  • URL: https://api.varg.ai/v2/me/connection
  • Auth: HTTP bearer

Request body

client_idstring

Required for an app session; a connected app may omit it or must send its own.

team_idstring uuid nullable

Team to bind to, or null/omitted for the personal account.

workspace_idstring nullable

Default folder in the selected scope, or null.

Response

The stored binding

client_idstring required
team_idstring nullable required

Null means the personal account.

team_slugstring nullable required
team_namestring nullable required
team_ownerboolean required

True when the user owns the bound team (owners manage its API keys; members only spend).

workspace_idstring nullable required

Default folder for the connection, if any.

status'ok' | 'no_team_access' required

ok means the binding is usable (team_id: null is the normal personal case). no_team_access means the user can no longer act in the bound team; clients should refuse to generate rather than fall back to the personal balance.

Changes