Getting started with API Lens¶
This guide takes you from installation to inspecting your first HTTP request.
← Documentation home · User guide →
1. Choose the correct package¶
API Lens uses a separate binary package for each Unreal Engine minor version. Install the package matching your project:
| Your project | Package to install |
|---|---|
| Unreal Engine 5.6 | API Lens 1.0.1 for UE 5.6 |
| Unreal Engine 5.7 | API Lens 1.0.1 for UE 5.7 |
| Unreal Engine 5.8 | API Lens 1.0.1 for UE 5.8 |
Do not copy a package built for one Engine minor into another. See Compatibility for details.
2. Enable the plugin¶
- Open your Unreal project.
- Go to Edit → Plugins.
- Search for API Lens.
- Enable the plugin.
- Restart Unreal Editor if prompted.
API Lens is an Editor-only development tool. Enabling it does not add a runtime feature to your packaged game.
3. Open API Lens¶
From the main Unreal Editor menu, choose:
Window → Developer Tools → Debug → API Lens
The panel can float as its own window or be docked beside your editor tabs.
4. Start your first capture¶
- Select Start capture in the API Lens header.
- Review the exclusive-capture notice and confirm when you are ready.
- Start Play in Editor or perform the action that makes your API request.
- Return to API Lens and select a request from the list.
- Open General, Headers, Request, or Response to inspect it.
API Lens observes Unreal's global HTTP callbacks while capture is active. Another plugin using the same callbacks can conflict with it. If your project includes analytics or backend monitoring plugins, review Compatibility before enabling capture.
5. Read a request¶
Each row shows the request time, status, method, duration, host, timeline, and stored URL path. Selecting a row opens its details:
- General — result, timing, size, origin, and privacy information.
- Headers — sanitized request and response headers.
- Request — the retained request-body preview.
- Response — the retained response-body preview.
Valid JSON can be viewed as a searchable tree, formatted text, or raw retained content.
6. Finish safely¶
Select Stop capture when you are done. Captured history remains in memory until it is cleared, evicted by configured limits, or the editor session ends.
Before copying or exporting any request, review the privacy and redaction guide.
Next steps¶
- Learn every dashboard control in the User guide.
- Understand captured data in Privacy and redaction.
- If the list stays empty, see Troubleshooting.