Skip to main content
PUT
Set a connection's team binding

Authorizations

Authorization
string
header
required

varg API key (varg_...). Get one at app.varg.ai or run bunx vargai login. App sessions may alternatively send a Supabase JWT.

Body

application/json
client_id
string

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

team_id
string<uuid> | null

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

workspace_id
string | null

Default folder in the selected scope, or null.

Response

The stored binding

Which team and default folder an OAuth connection works in.

client_id
string
required
team_id
string | null
required

Null means the personal account.

team_slug
string | null
required
team_name
string | null
required
team_owner
boolean
required

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

workspace_id
string | null
required

Default folder for the connection, if any.

status
enum<string>
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.

Available options:
ok,
no_team_access