> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vecbase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connections

> Connect an approved app or account to a workspace and choose which Agent may use it.

A Connection lets Vecbase use an external app or account that your team
approves. It can help an [Agent](/agents/overview) work with information
already stored elsewhere.

## What a Connection is

A Connection belongs to a [workspace](/workspace/overview). The
**Connections** screen shows the apps currently available and guides you
through their sign-in or setup.

Connecting an account and giving an Agent access are two separate choices. This
keeps one connected account from automatically becoming available to every
Agent.

## Connect an account

<Steps>
  <Step title="Open Connections">
    Choose **Connections** in the workspace.
  </Step>

  <Step title="Choose an available app">
    Select the app you need and review what Vecbase is asking to access.
  </Step>

  <Step title="Sign in and approve">
    Use the account that owns the needed information. Complete the provider's
    approval screen.
  </Step>

  <Step title="Confirm the connection">
    Return to Vecbase and check that the account appears as connected.
  </Step>
</Steps>

The available apps can change. Use the Connections screen as the current list
for your workspace.

## Give an Agent access

Open the Agent's [access settings](/administration/access-approvals) and
select the specific Connection it needs. If the app offers narrower choices,
select only the area required for that Agent's work.

Test with a small, reversible task first. For example, ask the Agent to find or
summarize information before asking it to create or change anything.

## Manage or remove

Remove Agent access when its role changes. Disconnect the account from the
workspace when the team no longer uses it or when the connected account should
change.

Disconnecting stops future use through Vecbase. It does not normally delete
the original information in the external app.

<Warning>
  **Keep sign-in details private**

  Never paste passwords, secret keys, or access tokens into a task or support
  message. Follow the [security guidance](/administration/security-data-retention)
  and use the Connection setup screen so credentials are handled through the
  intended flow.
</Warning>

## If it stops working

Check these in order:

1. the Connection still shows as active;
2. the Agent still has access to it;
3. the external account still has permission to the requested information;
4. the account owner has not revoked or changed access.

If needed, reconnect the account and retry a small task.