Skip to content
/
Toggle configuration
Last updated

Toggle Personal Connector Configuration

🔨 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.
POSThttps://api.freddy.aitronos.com/v1/personal-connectors/configurations/{config_id}/toggle

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.

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
  }'

Response

{
  "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"
}

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
Previous page
Next page