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

# Apps

> Search the app library and declare integrations on a coworker.

An app is a ready-made integration from the Rerun library: Stripe, Gmail, Notion, Slack and hundreds more. Declaring one on a coworker gives it that service tools. See [Apps](https://docs.rerun.build/agents/apps.md) for the concept.

> [!WARNING]
>
> No credential ever goes through the API. `attach_connector` takes no secret, by design. Never ask anyone for an API key, a password or a token: the account owner finishes the connection in the Rerun app.

## search\_connectors

Semantic search over the library. Describe the capability in natural language.

**query** `string`

For example `send emails` or `read a CRM`.

**category** `string`

One of `payments`, `ecommerce`, `crm`, `marketing`, `seo`, `analytics`, `dev`, `productivity`, `other`.

Each result carries `slug`, `name`, `category`, `summary`, `setup` and `setupReason`. Use the `slug` with `attach_connector`.

`setup` tells you what declaring it will leave behind:

| Value | Meaning |
| - | - |
| `active` | Works straight away, no credential needed |
| `needs_auth` | Waiting for a sign-in |
| `needs_config` | Waiting for a credential, or for the owner to pick between several ways to connect |

This search returns the best matches only. Use `list_connectors` when you need to know whether something exists at all.

## list\_connectors

Walks the whole library page by page, in a stable order.

**category** `string`

**limit** `number`

Default `60`, maximum `200`.

**offset** `number`

Default `0`.

Returns `total` alongside the page, so you know when you are done. Use it to prove an app is absent, which a semantic search can never do.

## list\_agent\_connectors

Lists the apps declared on a coworker with their real status and the tool names each one contributes.

**agentId** `string` *required*

This is the truth, whatever the catalog predicted at search time.

An app can be connected several times, one account each. Every row carries its `key`, the bare slug for the first account and `slug@id` for the others, and the `label` that tells the accounts apart.

## attach\_connector

Declares an app on a coworker.

**agentId** `string` *required*

**slug** `string` *required*

Catalog slug, from `search_connectors`.

**newInstance** `boolean`

Add another account of an app that supports several. Ignored for an app limited to one account.

When the app needs no credential and no sign-in, it is installed right away. Otherwise it is recorded as pending, and the account owner finishes the connection from the Rerun app, in the coworker panel under **Apps**.

The response carries the resulting `status`, the `key` of the account it declared, the available `authMethods` when one is still pending, and a `message` describing what is left to do.

> [!NOTE]
>
> Declaring an app on a coworker that will become a template is exactly the intended use. The person installing the template connects their own account.

## detach\_connector

Removes an app from a coworker: its tools, its credentials and the skill it installed.

**agentId** `string` *required*

**key** `string`

Account key from `list_agent_connectors`, for example `gmail@k3x9ab`. Targets one account of an app connected several times.

**slug** `string`

Catalog slug. Removes the first account of the app. Pass `key` or `slug`.

**confirm** `boolean` *required*

Must be `true`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.