# Update Personal Connector Configuration div strong 🔨 In Development — This section is still being developed and may change. Update an existing personal connector configuration. You can modify settings, credentials, name, description, and other properties. This endpoint allows partial updates to a configuration. Only the fields you provide will be updated; all other fields will remain unchanged. #### Path Parameters **`config_id`** string required The ID of the personal connector configuration to update (e.g., `pconf_abc123`). #### Request Body All fields are optional. Only provide the fields you want to update. **`name`** string optional Update the configuration name. **`configuration`** object optional Update connector-specific settings. This will merge with existing configuration. **`credentials`** object optional Update authentication credentials. The new credentials will be encrypted and stored securely. **`description`** string optional Update the configuration description. **`metadata`** object optional Update metadata. This will merge with existing metadata. Update configuration name ```bash curl https://api.freddy.aitronos.com/v1/personal-connectors/configurations/pconf_abc123 \ -X PATCH \ -H "Authorization: Bearer $FREDDY_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Updated Repository Name" }' ``` ```python import requests import os api_key = os.environ.get("FREDDY_API_KEY") headers = { "Authorization": f"Bearer {api_key}", "Content-Type": "application/json" } data = { "name": "Updated Repository Name" } response = requests.patch( "https://api.freddy.aitronos.com/v1/personal-connectors/configurations/pconf_abc123", headers=headers, json=data ) print(response.json()) ``` ```javascript const response = await fetch('https://api.freddy.aitronos.com/v1/personal-connectors/configurations/pconf_abc123', { method: 'PATCH', headers: { 'Authorization': `Bearer ${process.env.FREDDY_API_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ name: 'Updated Repository Name' }) }); const data = await response.json(); console.log(data); ``` Update configuration settings ```bash curl https://api.freddy.aitronos.com/v1/personal-connectors/configurations/pconf_abc123 \ -X PATCH \ -H "Authorization: Bearer $FREDDY_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "configuration": { "branch": "staging", "paths": ["src/", "tests/", "docs/"] } }' ``` ```python import requests import os api_key = os.environ.get("FREDDY_API_KEY") headers = { "Authorization": f"Bearer {api_key}", "Content-Type": "application/json" } data = { "configuration": { "branch": "staging", "paths": ["src/", "tests/", "docs/"] } } response = requests.patch( "https://api.freddy.aitronos.com/v1/personal-connectors/configurations/pconf_abc123", headers=headers, json=data ) print(response.json()) ``` ```javascript const response = await fetch('https://api.freddy.aitronos.com/v1/personal-connectors/configurations/pconf_abc123', { method: 'PATCH', headers: { 'Authorization': `Bearer ${process.env.FREDDY_API_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ configuration: { branch: 'staging', paths: ['src/', 'tests/', 'docs/'] } }) }); const data = await response.json(); console.log(data); ``` Update credentials ```bash curl https://api.freddy.aitronos.com/v1/personal-connectors/configurations/pconf_abc123 \ -X PATCH \ -H "Authorization: Bearer $FREDDY_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "credentials": { "accessToken": "ghp_NEW_GITHUB_PAT" } }' ``` ```python import requests import os api_key = os.environ.get("FREDDY_API_KEY") headers = { "Authorization": f"Bearer {api_key}", "Content-Type": "application/json" } data = { "credentials": { "accessToken": "ghp_NEW_GITHUB_PAT" } } response = requests.patch( "https://api.freddy.aitronos.com/v1/personal-connectors/configurations/pconf_abc123", headers=headers, json=data ) print(response.json()) ``` ```javascript const response = await fetch('https://api.freddy.aitronos.com/v1/personal-connectors/configurations/pconf_abc123', { method: 'PATCH', headers: { 'Authorization': `Bearer ${process.env.FREDDY_API_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ credentials: { accessToken: 'ghp_NEW_GITHUB_PAT' } }) }); 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": "Updated Repository Name", "configuration": { "repository": "aitronos/freddy-backend", "branch": "staging", "paths": ["src/", "tests/", "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-07T12:30:00Z" } ``` Errors ```json { "error": { "type": "invalid_request_error", "message": "Invalid configuration: 'branch' must be a string.", "code": "invalid_configuration", "param": "configuration.branch" } } ``` ```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" } } ``` ## Notes - Updating credentials will automatically invalidate the tool cache for this configuration - The `updatedAt` timestamp is automatically updated - Health status may change to `unknown` after updates until the next health check