Skip to main content
Connections attach a service credential to a workspace so agents can use it. Every command in this group requires --workspace — credential resolution depends on which workspace is asking.

​
connection providers

List the connector providers available to you.

​
connection list

List the connections for a workspace.
​
required
Workspace handle, UUID, or FQN.

​
connection add

Add a service connection, by OAuth or API key.
OAuth providers open a browser. API-key providers take --api-key, or prompt for it. This command has no --json.

​
connection test

Run a live health check against a provider connection.
This actually calls the provider, so it catches an expired or revoked token that a listing would still show as present. No --json.

​
connection resolve

Show the tier-by-tier credential resolution walk for a provider.
This answers “which credential will my agent actually get, and why”. It walks personal, workspace, and org vaults in order and shows what matched at each tier. Reach for it whenever an agent behaves as though it has the wrong account.

​
connection remove

If exactly one credential exists for the provider it is removed directly. If several do, the command asks you to disambiguate with --id rather than guessing. No --json.

​
See also