diff --git a/packages/swift-platform-sdk/Sources/BLFeatureFlagClient.swift b/packages/swift-platform-sdk/Sources/BLFeatureFlagClient.swift
index 62260ad0..7c89565e 100644
--- a/packages/swift-platform-sdk/Sources/BLFeatureFlagClient.swift
+++ b/packages/swift-platform-sdk/Sources/BLFeatureFlagClient.swift
@@ -1,5 +1,5 @@
 // ── Feature Flag Client ──────────────────────────────────────
-// Generic feature flag polling from platform-service /flags/poll.
+// Generic feature flag polling from platform-service /api/flags/poll.
 // Flags cached in memory, re-polled at configurable interval.
 // Matches the platform-service flags module API.
 
diff --git a/packages/swift-platform-sdk/Sources/BLTelemetryClient.swift b/packages/swift-platform-sdk/Sources/BLTelemetryClient.swift
index efa3da46..1d5350c7 100644
--- a/packages/swift-platform-sdk/Sources/BLTelemetryClient.swift
+++ b/packages/swift-platform-sdk/Sources/BLTelemetryClient.swift
@@ -5,7 +5,7 @@
 
 import Foundation
 
-/// Telemetry event matching the platform-service /telemetry/events schema.
+/// Telemetry event matching the platform-service /api/telemetry/events schema.
 public struct BLTelemetryEvent: Codable, Sendable {
     public let id: String
     public let productId: String
diff --git a/packages/swift-platform-sdk/Sources/ByteLystPlatformSDK.swift b/packages/swift-platform-sdk/Sources/ByteLystPlatformSDK.swift
index fb981c02..8da8a2ae 100644
--- a/packages/swift-platform-sdk/Sources/ByteLystPlatformSDK.swift
+++ b/packages/swift-platform-sdk/Sources/ByteLystPlatformSDK.swift
@@ -21,7 +21,7 @@
 //   - BLKeychain            — Keychain CRUD (configurable service string)
 //   - BLTelemetryClient     — Telemetry event queue + batch flush
 //   - BLAuthClient          — Full auth operations (login, register, refresh, password ops)
-//   - BLFeatureFlagClient   — Feature flag polling from /flags/poll
+//   - BLFeatureFlagClient   — Feature flag polling from /api/flags/poll
 //   - BLSyncEngine          — Generic offline-first sync with BLSyncAdapter protocol
 //   - BLBlobClient          — Azure Blob Storage upload via SAS tokens
 //   - BLKillSwitchClient    — Kill switch check from platform-service