# Toggle Personal Connector Configuration

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


Enable or disable a personal connector configuration. Disabled configurations will not be available for use by assistants.

This endpoint allows you to quickly enable or disable a configuration without deleting it. When disabled, the configuration's tools will not be available to any assistants, even if `personalConnectorsEnabled` is set to `true` in the Responses API.

#### Path Parameters

**`config_id`** string required
The ID of the personal connector configuration to toggle (e.g., `pconf_abc123`).

#### Request Body

**`enabled`** boolean required
Set to `true` to enable the configuration, or `false` to disable it.

Disable configuration

```bash
curl https://api.freddy.aitronos.com/v1/personal-connectors/configurations/pconf_abc123/toggle \
  -X POST \
  -H "Authorization: Bearer $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": false
  }'
```


```python
import requests
import os

api_key = os.environ.get("FREDDY_API_KEY")
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}
data = {"enabled": False}

response = requests.post(
    "https://api.freddy.aitronos.com/v1/personal-connectors/configurations/pconf_abc123/toggle",
    headers=headers,
    json=data
)

print(response.json())
```


```javascript
const response = await fetch('https://api.freddy.aitronos.com/v1/personal-connectors/configurations/pconf_abc123/toggle', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.FREDDY_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    enabled: false
  })
});

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

Enable configuration

```bash
curl https://api.freddy.aitronos.com/v1/personal-connectors/configurations/pconf_abc123/toggle \
  -X POST \
  -H "Authorization: Bearer $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true
  }'
```


```python
import requests
import os

api_key = os.environ.get("FREDDY_API_KEY")
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}
data = {"enabled": True}

response = requests.post(
    "https://api.freddy.aitronos.com/v1/personal-connectors/configurations/pconf_abc123/toggle",
    headers=headers,
    json=data
)

print(response.json())
```


```javascript
const response = await fetch('https://api.freddy.aitronos.com/v1/personal-connectors/configurations/pconf_abc123/toggle', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.FREDDY_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    enabled: true
  })
});

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

## Response

200 OK

```json
{
  "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": false,
  "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-07T12:45:00Z"
}
```

Errors

```json
{
  "error": {
    "type": "invalid_request_error",
    "message": "Missing required field: 'enabled'",
    "code": "missing_required_field",
    "param": "enabled"
  }
}
```


```json
{
  "error": {
    "type": "not_found_error",
    "message": "Personal connector configuration with ID 'pconf_abc123' not found.",
    "code": "configuration_not_found"
  }
}
```


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

## Cache Invalidation

When a configuration is toggled, the following happens:

- **Disabling:** The tool cache is immediately invalidated, and the configuration's tools are removed from all active assistant contexts.
- **Enabling:** The tool cache is refreshed on the next request that uses this configuration, ensuring the latest tools are available.


## Use Cases

- **Temporary Disable:** Temporarily disable a connector without losing your configuration (e.g., during maintenance)
- **Testing:** Disable production connectors while testing new configurations
- **Cost Control:** Disable expensive connectors when not actively needed
- **Troubleshooting:** Disable problematic connectors while investigating issues