# List Personal Connector Configurations

div
strong
🔨 In Development
 — This section is still being developed and may change.


Retrieve a list of all personal connector configurations for the authenticated user or API key. These configurations represent the user's specific setups for external services.

This endpoint returns a paginated list of `PersonalConnectorConfiguration` objects that belong to the authenticated user or API key. You can filter by connector type, enabled status, and more.

#### Query Parameters

**`personalConnectorId`** string optional
Filter by specific personal connector ID (e.g., `pcon_github`, `pcon_clickup`).

**`enabled`** boolean optional
Filter by enabled status. If `true`, returns only enabled configurations. If `false`, returns only disabled configurations.

**`healthStatus`** string optional
Filter by health status. Values: `healthy`, `unhealthy`, `unknown`.

**`limit`** integer optional · Defaults to `20`
A limit on the number of objects to be returned. Limit can range between 1 and 100.

**`after`** string optional
A cursor for use in pagination. `after` is an object ID that defines your place in the list.

List all configurations

```bash
curl https://api.freddy.aitronos.com/v1/personal-connectors/configurations \
  -H "Authorization: Bearer $FREDDY_API_KEY"
```


```python
import requests
import os

api_key = os.environ.get("FREDDY_API_KEY")
headers = {"Authorization": f"Bearer {api_key}"}

response = requests.get(
    "https://api.freddy.aitronos.com/v1/personal-connectors/configurations",
    headers=headers
)

print(response.json())
```


```javascript
const response = await fetch('https://api.freddy.aitronos.com/v1/personal-connectors/configurations', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${process.env.FREDDY_API_KEY}`
  }
});

const data = await response.json();
console.log(data);
```

List enabled configurations only

```bash
curl "https://api.freddy.aitronos.com/v1/personal-connectors/configurations?enabled=true" \
  -H "Authorization: Bearer $FREDDY_API_KEY"
```


```python
import requests
import os

api_key = os.environ.get("FREDDY_API_KEY")
headers = {"Authorization": f"Bearer {api_key}"}
params = {"enabled": True}

response = requests.get(
    "https://api.freddy.aitronos.com/v1/personal-connectors/configurations",
    headers=headers,
    params=params
)

print(response.json())
```


```javascript
const response = await fetch('https://api.freddy.aitronos.com/v1/personal-connectors/configurations?enabled=true', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${process.env.FREDDY_API_KEY}`
  }
});

const data = await response.json();
console.log(data);
```

Filter by connector type

```bash
curl "https://api.freddy.aitronos.com/v1/personal-connectors/configurations?personalConnectorId=pcon_clickup" \
  -H "Authorization: Bearer $FREDDY_API_KEY"
```


```python
import requests
import os

api_key = os.environ.get("FREDDY_API_KEY")
headers = {"Authorization": f"Bearer {api_key}"}
params = {"personalConnectorId": "pcon_clickup"}

response = requests.get(
    "https://api.freddy.aitronos.com/v1/personal-connectors/configurations",
    headers=headers,
    params=params
)

print(response.json())
```


```javascript
const response = await fetch('https://api.freddy.aitronos.com/v1/personal-connectors/configurations?personalConnectorId=pcon_clickup', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${process.env.FREDDY_API_KEY}`
  }
});

const data = await response.json();
console.log(data);
```

## Response

200 OK

```json
{
  "object": "list",
  "data": [
    {
      "id": "pconf_abc123",
      "object": "personal_connector.configuration",
      "userId": "user_xyz789",
      "apiKeyId": null,
      "organizationId": "org_123",
      "personalConnectorId": "pcon_github",
      "name": "My Backend Repo",
      "configuration": {
        "repository": "aitronos/freddy-backend",
        "branch": "main",
        "paths": ["src/", "docs/"]
      },
      "credentials": "***REDACTED***",
      "enabled": true,
      "healthStatus": "healthy",
      "lastSyncAt": "2025-10-07T10:45:00Z",
      "lastError": null,
      "description": "Access to Freddy Backend repository for AI assistance.",
      "metadata": {},
      "createdAt": "2025-10-07T10:45:00Z",
      "updatedAt": "2025-10-07T10:45:00Z"
    },
    {
      "id": "pconf_def456",
      "object": "personal_connector.configuration",
      "userId": "user_xyz789",
      "apiKeyId": null,
      "organizationId": "org_123",
      "personalConnectorId": "pcon_clickup",
      "name": "My ClickUp Tasks",
      "configuration": {
        "workspaceId": "12345678",
        "defaultListId": "987654321"
      },
      "credentials": "***REDACTED***",
      "enabled": true,
      "healthStatus": "healthy",
      "lastSyncAt": "2025-10-07T11:00:00Z",
      "lastError": null,
      "shared": false,
      "sharedWith": null,
      "description": "Personal ClickUp integration for task management.",
      "metadata": {},
      "createdAt": "2025-10-07T10:50:00Z",
      "updatedAt": "2025-10-07T11:00:00Z"
    }
  ],
  "has_more": false
}
```

Errors

```json
{
  "error": {
    "type": "authentication_error",
    "message": "Invalid API key",
    "code": "invalid_api_key"
  }
}
```