Skip to main content

Path Adapter

⚠️ Breaking Change (v0.2.0): SDK now uses /v1/apps/* paths.

The path adapter transforms modern /v1/apps/* paths to legacy backend paths for backward compatibility.

Quick Start​

For current backends (don't support /v1/apps/* yet), enable the adapter:

# .env
CPOD_ENABLE_PATH_ADAPTER=true

For future backends (support /v1/apps/*), keep it disabled (default).

How It Works​

When enabled, the adapter transforms paths:

SDK PathBackend Path
/v1/apps/users/users
/v1/apps/experts/experts
/v1/apps/mcp-servers/api/v1/mcp-servers

When disabled (default), paths go through unchanged:

SDK PathBackend Path
/v1/apps/users/v1/apps/users

Configuration Options​

# .env
CPOD_ENABLE_PATH_ADAPTER=true   # enabled
CPOD_ENABLE_PATH_ADAPTER=false  # disabled (default)

Option 2: SDK Config​

initSDK({
  baseUrl: process.env.NEXT_PUBLIC_CPOD_BASE_URL!,
  apiKey: process.env.CPOD_API_KEY!,
  enablePathAdapter: true,  // For current backends
});

Priority: SDK config > Environment variable > Default (false)

When to Enable​

Enable the adapter if:

  • Your backend uses inconsistent API path prefixes
  • You need automatic path transformation for legacy endpoints