---
title: "List installed connectors"
method: GET
path: "/v1/agents/{agent_id}/connectors"
tags: ["Connectors"]
---

# List installed connectors

`GET /v1/agents/{agent_id}/connectors`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/agents/{agent_id}/connectors`
- Auth: HTTP bearer

Connectors installed on this agent, and whether each one has actually
been connected — an install creates the binding, but the binding is not
usable until the OAuth round trip completes.

## Path parameters

- `agent_id` string, uuid, required

## Response `200`

Installed connectors

- object
  - `connectors` InstalledConnector[]
    - `binding_id` string, uuid, required
    - `binding_name` string, required
    - `preset_slug` string, required
    - `display_name` string, nullable: Null if the preset has since been retired from the catalogue.
    - `is_active` boolean, required
    - `connected` boolean, required: The OAuth round trip completed and a token is stored.
    - `needs_reauth` boolean, required: The stored token was rejected; the user must reconnect.
    - `created_at` string, date-time, required

## Other responses

- `403`: Insufficient permissions
- `404`: Resource not found

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/5fa0918f3b41?raw)