Skip to content
Last updated

🔨 In Development — This section is still being developed and may change.
Modify an existing MCP configuration's settings, sharing permissions, or metadata.
PATCHhttps://api.freddy.aitronos.com/v1/mcp/configurations/{id}

Update any aspect of an MCP configuration including connector settings, name, description, sharing permissions, and metadata. Only fields provided in the request will be updated; omitted fields remain unchanged.

Path Parameters

id string required

The ID of the MCP configuration to update. Example: mcp_config_abc123.

Request Body

name string optional

Updated human-readable name for the configuration.

configuration object optional

Updated connector-specific configuration settings. Completely replaces the existing configuration object.

description string optional

Updated description. Pass empty string to clear.

shared boolean optional

Update sharing status. Setting to false removes all sharing permissions.

sharedWith object optional

Update sharing permissions. Completely replaces existing sharing settings.

Show properties

users array optional

Array of user IDs to share with. Replaces existing user list.

teams array optional

Array of team IDs to share with. Replaces existing team list.

organization boolean optional

Share with entire organization. Overrides user and team lists when true.

permissions string optional

Access level for shared users. Values: read, write, admin.

metadata object optional

Updated metadata. Merges with existing metadata (specify null for keys to remove them).

Bash
curl -X PATCH https://api.freddy.aitronos.com/v1/mcp/configurations/mcp_config_abc123 \
  -H "Authorization: Bearer $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Engineering Docs (Updated)",
    "configuration": {
      "folderId": "1a2b3c4d5e",
      "includeSubfolders": true,
      "mimeTypes": ["application/pdf", "text/plain"]
    }
  }'

Response

{
  "id": "mcp_config_abc123",
  "object": "mcp.configuration",
  "name": "Engineering Docs (Updated)",
  "connectorId": "google_drive",
  "configuration": {
    "folderId": "1a2b3c4d5e",
    "includeSubfolders": true,
    "mimeTypes": ["application/pdf", "text/plain"]
  },
  "description": "Access to engineering documentation",
  "shared": true,
  "sharedWith": {
    "users": ["user_123", "user_456", "user_789"],
    "permissions": "read"
  },
  "metadata": {
    "environment": "production",
    "team": "engineering"
  },
  "createdAt": "2024-10-04T12:00:00Z",
  "updatedAt": "2024-10-04T15:45:00Z",
  "createdBy": "user_xyz789"
}