:::callout{intent="warning"}
Cohere's connector parameter was deprecated on September 15, 2025. For information on how to get connector-like functionality, check out our documentation on [multi-step tool use](https://docs.cohere.com/docs/tool-use-usage-patterns#multi-step-tool-use).
:::

Once your connector is deployed and registered, there are a couple of features that will help you to manage it.

## Listing your Connectors

You can see all the connectors registered under your organization through the [Cohere dashboard](https://dashboard.cohere.com/connectors). Alternatively, you can make a GET request like the one below:

:::code-group
```curl CURL
curl --request GET  
  --url 'https://api.cohere.ai/v1/connectors'  
  --header 'Authorization: Bearer {Cohere API key}'
```

```typescript TYPESCRIPT
const { CohereClient } = require("cohere-ai");
const cohere = new CohereClient({
    token: "Your API key",
});
(async () => {
  const connectors = await cohere.connectors.list();
  console.log(connectors);
})();
```

```python PYTHON
import cohere

# initialize the Cohere Client with an API Key

co = cohere.Client("YOUR_API_KEY")
connectors = co.list_connectors()

```
:::

## Authorizing an OAuth 2.0 Connector

If your connector is set up using OAuth 2.0, a user in your organization can authorize the connector through the dashboard by clicking on “connect your account”. Alternatively, you can make a request to the `/oauth/authorize` endpoint in your application. This will provide a redirect URL that the user can follow to authorize the OAuth application.

:::code-group
```curl CURL
curl --request POST  
  --url 'https://api.cohere.ai/v1/connectors/{connector-id}/oauth/authorize' 
  --header 'Authorization: Bearer {Cohere API key for user wishing to authorize}'
```

```typescript TYPESCRIPT
const { CohereClient } = require("cohere-ai");
const cohere = new CohereClient({
    token: "Your API key",
});
(async () => {
  const connector = await cohere.connectors.oAuthAuthorize("connector-id", {
    redirect_uri: "https://example.com/oauth/callback",
  });
  console.log(connector);
})();
```
:::

## Updating a Connector

You can enable and disable a connector [through the dashboard](https://dashboard.cohere.com/connectors). Additionally, you can update the connector name, URL, auth settings, and handle similar sorts of tasks through the API, as follows:

:::code-group
```curl CURL
curl --request PATCH  
  --url 'https://api.cohere.ai/v1/connectors/{id}' 
  --header 'Authorization: Bearer {Cohere API key}'  
  --header 'Content-Type: application/json'  
  --data '{  
        "name": "new connector name",  
        "url": "https://new-connector-example.com/search",  
        "auth_type": "oauth",  
        "oauth": {  
            "authorize_url": "https://new.com/authorize",  
            "token_url": "https://new.com/access",  
            "scope": "new_scope"  
        },  
        "active": true,  
    }'
```

```python PYTHON
import cohere

# initialize the Cohere Client with an API Key
co = cohere.Client("YOUR_API_KEY")
connectors = co.update_connector(
    connector_id, name="new name", url="new_url"
)
```

```typescript TYPESCRIPT
const { CohereClient } = require("cohere-ai");
const cohere = new CohereClient({
    token: "Your API key",
});
(async () => {
  const connector = await cohere.connectors.update(connector.id, {
    name: "test-connector-renamed",
    description: "A test connector renamed"
  });
  console.log(connector);
})();
```
:::

## Debugging a Connector

To debug issues with a registered connector, you can follow the steps in this section.

Step 1: Make a streaming request to the connector using the Chat API and check the search results for the error. Here's an example request:

:::code-group
```python PYTHON
import cohere

co = cohere.Client("Your API key")
response = co.chat(
    message="What is the chemical formula for glucose?",
    stream=True,
    connectors=[
        {"id": "example_connector_id"}
    ],  # this is from the create step
)
```

```curl CURL
curl --request POST  \
--url <https://api.cohere.ai/chat>  \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {Your API key}' \
--data '
{
    "stream" : true,  
    "message": "What is the chemical formula for glucose?",
    "connectors": [{"id": "example_connector_id"}]
}
```

```typescript TYPESCRIPT
import { CohereClient } from "cohere-ai";
const cohere = new CohereClient({
    token: "YOUR_API_KEY",
});
(async () => {
    const response = await cohere.chat({
      message:"What is the chemical formula for glucose?", 
      stream:True,
      connectors:[{"id": "web-search"}],  
    });
    console.log("Received response", response);
})();
```

```go GO
import (
  "context"
  
  cohere       "github.com/cohere-ai/cohere-go/v2"
  cohereclient "github.com/cohere-ai/cohere-go/v2/client"
)
client := cohereclient.NewClient(cohereclient.WithToken("<YOUR_AUTH_TOKEN>"))
response, err := client.Chat(
  context.TODO(),
  &cohere.ChatRequest{
    Stream: true,
    Message: "What is the chemical formula for glucose?",
    Connectors:[]*cohereclient.ChatConnector{{Id: "web-search"}}, 
  } 
)
```
:::

The response in the search results array should contain the error message from the connector:

```json Example Response JSON
 "search_results": [  
    {  
        "connector": {  
            "id": "connector_id"  
        },  
        "error_message":"connector error message"  
    }
```

Step 2: In Cohere’s [dashboard](https://dashboard.cohere.com/connectors) you can view and filter the logs from calling your connector. Change the response filter to “error” to see the error messages returned from your connector.

## Related pages

- [Changelog](../changelog.md)
- [Cohere](../index.md)
- [Cohere API](./cohere-api-index.md)
- [Cohere Labs](./cohere-labs-index.md)
- [Cohere Platform](./cohere-platform-index.md)
- [Cookbooks](./cookbooks-index.md)
- [Deployment Options](./deployment-options-index.md)
- [Embeddings (Vectors, Search, Retrieval)](./embeddings-vectors-search-retrieval-index.md)
- [Get Started](./get-started-index.md)
- [Going to Production](./going-to-production-index.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.