For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
Resources
Log inGet a demo
Get startedConnectorsAPI reference
Get startedConnectorsAPI reference
    • Overview
    • How it works
    • Quickstart
    • Use cases
  • Setup
    • Building an agent
    • Context layer for employees
    • Local development
  • Build
  • Secure
    • Security Gateway
    • Standard Entity Rules
    • Custom Regex Rules
    • Violations and alerts
    • Rule Tester
  • Observe
    • Tool Call Logs
    • API Request Logs
    • Audit Trail
    • Webhooks
    • Playground
  • Administer
    • Team and roles
    • Single sign-on
    • SCIM provisioning
    • Multi-factor authentication
    • Access Keys
    • Application Credentials
    • Billing and usage
  • Resources
    • Troubleshooting
    • FAQ

Get started

  • Overview
  • Introduction
  • Unified API
  • Linked Account
  • Merge Link
  • Use cases

Implementation

  • Sandboxes
  • SDKs
  • API access
  • Syncing data
  • Writing data
  • Data minimization
  • Supplemental data
  • Errors
  • Integration metadata

API reference

  • ATS
  • HRIS
  • Accounting
  • Ticketing
  • CRM
  • File Storage
  • Knowledge Base
  • Chat

Resources

  • Help Center
  • Merge.dev
  • Changelog
© Merge 2026Terms of usePrivacy policy
UnifiedAgent HandlerGateway
UnifiedAgent HandlerGateway
Resources
Log inGet a demo
On this page
  • When to look at API logs vs Tool Call Logs
  • What’s captured
  • Filtering
  • Drilling into a request
  • Common debugging flows
  • Retention
  • Next
Observe

API Request Logs

HTTP requests against the Agent Handler API, captured for debugging.
Was this page helpful?
Previous

Tool Call Logs

Next

Audit Trail

API Request Logs capture the HTTP requests your backend makes against the Agent Handler API itself - POST /registered-users, GET /tool-packs, POST /credentials/export, and so on. Different from Tool Call Logs, which capture what the agent does once it’s connected to the MCP server.

You’ll mostly use these when you’re debugging your own integration code rather than the agent’s behavior.

When to look at API logs vs Tool Call Logs

QuestionLook here
The agent called the wrong tool.Tool Call Logs
The agent’s tool call returned an error.Tool Call Logs
My backend’s request to create a Registered User is failing.API Request Logs
Why did my Link token request return 400?API Request Logs
A webhook subscription update isn’t taking effect.API Request Logs
A tool call was redacted unexpectedly.Tool Call Logs

What’s captured

Per request:

  • Method and path - POST /api/v1/registered-users, GET /api/v1/tool-packs, etc.
  • Status code.
  • Latency - total wall-clock time from receipt to response.
  • Request body - sensitive values (API keys, secrets) redacted.
  • Response body - full, post-redaction.
  • API key prefix - the first few characters of the key used (so you can correlate against your secret store without exposing the full key).
  • Source IP - useful when you have multiple backends sharing one key.
  • Timestamp.

Filtering

The filter bar covers:

  • Method (GET / POST / PATCH / DELETE).
  • Path pattern - glob-style, like /registered-users/*.
  • Status - success only, errors only, or specific codes.
  • API key - narrow to one key (production, or a specific test key).
  • Date range.

A common debugging shape: “all 4xx and 5xx responses on /registered-users/* in the last hour.”

Drilling into a request

Click any row to open the full detail. You see:

  • The full request URL with query parameters.
  • The full request headers (Authorization redacted to its prefix).
  • The full request body.
  • The full response status, headers, and body.
  • The trace ID - useful when you want to file a support ticket; including this lets us find your request in our backend logs in seconds.

Common debugging flows

“My backend is creating Registered Users that aren’t appearing in the dashboard.”

Filter to POST /api/v1/registered-users, look at the response codes. If they’re 200, check whether you’re looking at the right environment in the dashboard (test vs production). If they’re 4xx, the response body says exactly what’s wrong.

“My API calls were working an hour ago and now everything is 401.”

Someone rotated the API key. Filter by API key prefix; if the prefix you’re using doesn’t appear, the key was regenerated. Update your secret store.

“My webhook deliveries stopped.”

Filter to the webhook subscription endpoints. If recent calls show 200 responses but no events are flowing, the issue is on the receiving side, not Agent Handler’s side. The webhook delivery log has more detail on individual delivery attempts.

Retention

90 days on standard plans, longer on Enterprise. Bulk export is available for any filtered view. The logs aren’t webhook-streamed today; for SIEM forwarding, pull via export or the API listing endpoints.

Next

Track admin actions across your organization with the Audit Trail.