title: Get Connector Details
keywords:

- get connector details
- get
- connector
- details


# Get Connector Details

Get details of a specific connector by tool_key.

#### Path Parameters

**`tool_key`** string required

The tool key parameter.

#### Query Parameters

**`organization_id`** string optional

Organization ID

## Returns

**`id`** string

Unique connector identifier

**`tool_key`** string

Tool key identifier (e.g., 'slack', 'github')

**`display_name`** string

Human-readable display name

**`description`** string or null

Tool description

**`category`** string or null

Tool category (e.g., 'communication', 'development')

**`icon_url`** string or null

URL to tool icon/logo

**`is_connected`** boolean

Whether user has connected this tool

**`connection_id`** string or null

Connection ID if connected

**`release_channel`** string

Release channel: 'stable' for Aitronos-auth connectors, 'beta' for partner-auth connectors

Example

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


```python Python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]

response = requests.get(
    "https://api.aitronos.com/v1/personal-connectors/available/{tool_key}",
    headers={"X-API-Key": api_key}
)

print(response.json())
```


```javascript JavaScript
const apiKey = process.env.FREDDY_API_KEY;

const response = await fetch('https://api.aitronos.com/v1/personal-connectors/available/{tool_key}', {
  method: 'GET',
  headers: {
    'X-API-Key': apiKey
  }
});

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

**Response:**


```json 200 OK
{
  "id": "abc123def456",
  "tool_key": "slack",
  "display_name": "My Resource",
  "description": "A description of the resource",
  "category": "general",
  "icon_url": "https://example.com/resource",
  "is_connected": false,
  "connection_id": "conn_abc123def456",
  "release_channel": "beta"
}
```

Errors

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


```json 403 Forbidden
{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_PERMISSIONS",
    "message": "You do not have permission to access this resource.",
    "system_message": "Insufficient permissions for this operation",
    "type": "authorization_error",
    "status": 403,
    "trace_id": "req_def456uvw",
    "timestamp": "2025-11-11T10:30:00Z",
    "details": {}
  }
}
```

## Related Resources

- [List Connectors](/docs/api-reference/connectors/introduction)