---
title: link
description: API reference for the `turbo link` command
product: turborepo
type: reference
summary: All flags and options for the `turbo link` command that connects your repository to Remote Cache.
related:
  - /docs/reference/unlink
  - /docs/reference/login
  - /docs/core-concepts/remote-caching
---

# link

Link the repository to a Remote Cache provider.

```bash title="Terminal"
turbo link
```

The selected owner (either a user or an organization) will be able to share [cache artifacts](/docs/core-concepts/remote-caching) through [Remote Caching](/docs/core-concepts/remote-caching).

Flag options [#flag-options]

--api <url> [#--api-url]

Specifies the URL of your Remote Cache provider.

```bash title="Terminal"
turbo link --api=https://example.com
```

--yes [#--yes]

Answer yes to all prompts

```bash title="Terminal"
turbo link --yes
```

--scope <scope> [#--scope-scope]

The scope to which you are linking. For example, when using Vercel, this is your Vercel team's slug.

```bash title="Terminal"
turbo link --scope=your-team
```

---

[View full sitemap](/sitemap.md)