Troubleshooting¶
← Documentation home · Getting started
API Lens does not appear in the menu¶
- Confirm the installed package matches Unreal Engine 5.6, 5.7, or 5.8.
- Open Edit → Plugins and verify API Lens is enabled.
- Restart Unreal Editor after enabling the plugin.
- Look under Window → Developer Tools → Debug → API Lens.
If Unreal reports that the module was built for another Engine version, replace it with the correct package instead of forcing the mismatched binary to load.
No requests appear¶
- Confirm the header says Capturing · Exclusive.
- Generate a request after capture has started.
- Disable active filters or select Clear filters.
- Turn off Hide Epic if you are specifically testing known Epic telemetry.
- Verify the request uses Unreal's standard
FHttpModulestack.
Traffic from custom sockets or an SDK with its own network implementation is outside API Lens capture scope.
Capture conflicts with another plugin¶
Only one consumer can own the supported global HTTP observer at a time. Stop API Lens capture or disable the competing observer, then test again. API Lens cannot automatically restore an unknown previous callback owner.
A body is missing¶
API Lens may omit a body preview when the payload is:
- Binary or invalid UTF-8.
- Declared as structured data but cannot be parsed safely.
- Streamed without a retained application copy.
- Disabled by project body-capture settings.
- Outside the configured preview boundary.
The request inspector states how each body was classified.
Values appear as redacted¶
This is expected when a recognized sensitive header, query parameter, or structured field is captured with redaction enabled.
Use Edit and resend to supply a replacement value. Disable redaction only when necessary and review Privacy and redaction first.
Replay is unavailable¶
One-click replay is restricted when:
- The original body was unavailable.
- A required value was redacted.
- The HTTP method can change server data.
- Capture is not active.
Use Edit and resend to review and complete the request safely.
Requests stay pending or show Abandoned¶
A request remains pending until Unreal reports its outcome. If completion never arrives, API Lens eventually marks it Abandoned instead of retaining an unfinished record indefinitely.
Inspect Unreal's HTTP logs and verify the destination server can be reached.
The Dropped counter increases¶
Hover the counter to see the cause. Records may be omitted or evicted because of privacy policy, queue pressure, record-count limits, or memory limits. Reduce traffic, clear history, or adjust the relevant project settings before testing again.
Before requesting support¶
Collect:
- API Lens version.
- Exact Unreal Engine version.
- Steps needed to reproduce the problem.
- Expected and actual behavior.
- Sanitized logs or screenshots, when helpful.
Never include real credentials, tokens, authorization headers, private URLs, personal data, or unredacted payloads. Then open a GitLab Work item.