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

# roark connections agent discover

> Discover agents with a platform API key

Lists the agents a Retell, Vapi, ElevenLabs or Bland API key can see, without storing anything. Use it to check a key and to pick `agentIds` before connecting. A key the platform refuses returns 400.

```bash Synopsis theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark connections agent discover [options]
```

> [!NOTE]
>
> Calls `POST /v1/connections/agent/discover`

## Options

**--provider** `string` *required*

Platforms whose agents can be listed with a key. One of `RETELL`, `VAPI`, `ELEVEN_LABS`, `BLAND`

**--api-key** `string` *required*

The platform API key to list agents with. Stored nowhere.

## Example

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark connections agent discover --provider <value> --api-key <value>
```

Every command also takes the [global options](https://docs.roark.ai/cli-reference/overview.md#global-options) and sets one
of the [exit codes](https://docs.roark.ai/cli-reference/overview.md#exit-codes).


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