# List Available Connectors

Get a list of all available connector types that can be connected.

## Returns

A list of available personal connector types with their metadata including type, name, description, icon ID, icon URL, and OAuth requirements.

Request

```bash
curl "https://api.aitronos.com/v1/personal-connectors/available" \
  -H "X-API-Key: $FREDDY_API_KEY"
```


```python
import requests
import os

api_key = os.environ.get("FREDDY_API_KEY")
headers = {
    "X-API-Key": api_key
}

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

connectors = response.json()
print(f"Found {len(connectors)} connector types")
```


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

const connectors = await response.json();
console.log(`Found ${connectors.length} connector types`);
```

**Response:**

200 OK

```json
[
  {
    "type": "atlassian",
    "name": "Atlassian",
    "description": "Connect to Atlassian Jira and Confluence to access issues, pages, and projects",
    "icon_id": "icon_atlassian123",
    "icon_url": "https://wac-cdn.atlassian.com/assets/img/favicons/atlassian/favicon.png",
    "requires_oauth": true
  },
  {
    "type": "github",
    "name": "GitHub",
    "description": "Connect to GitHub to access repositories, issues, and pull requests",
    "icon_url": "https://github.githubassets.com/favicons/favicon.png",
    "requires_oauth": true
  },
  {
    "type": "clickup",
    "name": "ClickUp",
    "description": "Connect to ClickUp to access tasks, lists, and workspaces",
    "icon_url": "https://clickup.com/favicon.ico",
    "requires_oauth": true
  },
  {
    "type": "notion",
    "name": "Notion",
    "description": "Connect to Notion to access pages, databases, and workspaces",
    "icon_url": "https://www.notion.so/images/favicon.ico",
    "requires_oauth": true
  }
]
```

400 Bad Request

```json
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters",
    "system_message": "Validation failed",
    "type": "validation_error",
    "status": 400,
    "trace_id": "req_xyz789",
    "timestamp": "2025-11-13T10:30:00Z"
  }
}
```

401 Unauthorized

```json
{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentication required. Please provide a valid API key.",
    "system_message": "Missing or invalid authorization header",
    "type": "authentication_error",
    "status": 401,
    "trace_id": "req_abc123",
    "timestamp": "2025-11-13T10:30:00Z"
  }
}
```

403 Forbidden

```json
{
  "success": false,
  "error": {
    "code": "FORBIDDEN",
    "message": "You do not have permission to perform this action.",
    "system_message": "Insufficient permissions",
    "type": "authorization_error",
    "status": 403,
    "trace_id": "req_def456",
    "timestamp": "2025-11-13T10:30:00Z"
  }
}
```

429 Rate Limit

```json
{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Please try again later.",
    "system_message": "Rate limit exceeded for endpoint",
    "type": "rate_limit_error",
    "status": 429,
    "details": {
      "retry_after": 60,
      "limit": 100,
      "remaining": 0,
      "reset_at": "2025-11-13T10:31:00Z"
    },
    "trace_id": "req_ghi789",
    "timestamp": "2025-11-13T10:30:00Z"
  }
}
```

500 Server Error

```json
{
  "success": false,
  "error": {
    "code": "INTERNAL_SERVER_ERROR",
    "message": "An unexpected error occurred. Please try again later.",
    "system_message": "Database connection timeout",
    "type": "server_error",
    "status": 500,
    "trace_id": "req_jkl012",
    "timestamp": "2025-11-13T10:30:00Z"
  }
}
```