Skip to content

Logs

Operations

Export Route Logs

Request

Export route logs for audit and reporting purposes.

Overview

The Route Logs API provides comprehensive audit trails for all routing, conversion, merging, and enrichment actions performed on Salesforce objects. It supports filtering, export formats, and configurable retention policies.

Query Parameters

  • from: Start date for log export (ISO format, required)
  • to: End date for log export (ISO format, required)
  • pool: Filter by specific pool name (optional)
  • object: Filter by specific object type (Lead, Contact, Account, Opportunity) (optional)
  • action: Filter by specific action type (assign, convert, merge, enrich) (optional)
  • format: Export format (json, csv) (optional, default: json)
  • include_diff: Include diff data in export (optional, default: true)
  • limit: Maximum number of records to return (optional, default: 1000, max: 10000)

Response Fields

Each log entry includes:

  • timestamp: ISO timestamp of the action
  • object: Salesforce object type
  • object_id: Salesforce ID of the object
  • action: Action performed (assign, convert, merge, enrich)
  • pool: Round-robin pool name (for assign actions)
  • assigned_to: Salesforce ID of assigned user (for assign actions)
  • prev_owner: Previous owner ID (for assign/convert actions)
  • sequence: Round-robin sequence number (for assign actions)
  • reason: Reason for the action
  • request_id: Request ID for tracking
  • idempotency_key: Idempotency key for duplicate prevention
  • diff: Field changes for enrichment/merge actions

Export Formats

JSON Format (Default)

Returns structured JSON data with full field information.

CSV Format

Returns comma-separated values suitable for spreadsheet applications.

  • Headers: timestamp, object, object_id, action, pool, assigned_to, prev_owner, sequence, reason, request_id, idempotency_key, diff
  • Diff data is JSON-encoded in the diff column

Use Cases

  • Audit Compliance: Track all actions for regulatory compliance
  • Performance Analysis: Analyze routing patterns and efficiency
  • User Activity: Monitor user assignments and activity
  • Enrichment Tracking: Track data enrichment changes and sources
  • Troubleshooting: Debug routing issues and user assignments

Retention Policy

  • Default Retention: 365 days
  • Maximum Retention: 1095 days (3 years)
  • Auto Cleanup: Enabled by default (daily at 2 AM)
  • Configurable: Retention can be adjusted per organization

Rate Limits

  • Standard Export: 10 requests per minute
  • Large Exports: 2 requests per minute (for exports > 5000 records)
  • Statistics: 20 requests per minute
Security
BearerAuth
Query
from_datestring, (date-time)(From Date)required

Start date for log export (ISO format)

to_datestring, (date-time)(To Date)required

End date for log export (ISO format)

poolstring or null(Pool)
Any of:

Filter by specific pool name

string
objectstring or null(Object)
Any of:

Filter by specific object type

string
actionstring or null(Action)
Any of:

Filter by specific action type

string
formatstring(Format)

Export format (json, csv)

Default:"json"
include_diffboolean(Include Diff)

Include diff data in export

Default:true
limitinteger, [ 1 .. 10000 ](Limit)

Maximum number of records to return

Default:1000
curl -i -X GET \
  'https://api-gateway.agenthq.withlantern.com/v1/logs/routing?from_date=2019-08-24T14%3A15%3A22Z&to_date=2019-08-24T14%3A15%3A22Z&pool=string&object=string&action=string&format=json&include_diff=true&limit=1000' \
  -H 'Authorization: Bearer <YOUR_ApiToken_HERE>'

Responses

Success Response

Bodyapplication/json
Array [
timestampstring, (date-time)(Timestamp)required

ISO timestamp of the action

objectstring(Object)required

Salesforce object type

Enum:"Lead""Contact""Account""Opportunity"
object_idstring(Object Id)required

Salesforce ID of the object

actionstring(Action)required

Action performed on the object

Enum:"assign""convert""merge""enrich"
poolstring or null(Pool)
Any of:

Round-robin pool name (for assign actions)

string
assigned_tostring or null(Assigned To)
Any of:

Salesforce ID of assigned user (for assign actions)

string
prev_ownerstring or null(Prev Owner)
Any of:

Previous owner ID (for assign/convert actions)

string
sequenceinteger or null(Sequence)
Any of:

Round-robin sequence number (for assign actions)

integer
reasonstring or null(Reason)
Any of:

Reason for the action (e.g., 'round_robin', 'manual_override')

string
request_idstring or null(Request Id)
Any of:

Request ID for tracking

string
idempotency_keystring or null(Idempotency Key)
Any of:

Idempotency key for duplicate prevention

string
diffobject or null(Diff)
Any of:

Field changes for enrichment/merge actions

]
Response
[
  {
    "timestamp": "2025-09-18T16:12:00Z",
    "object": "Lead",
    "object_id": "00Qxx0000Lm789U",
    "action": "assign",
    "pool": "SDR_WEST_01",
    "assigned_to": "005xx0002ABCDE",
    "prev_owner": "005xx0001ZZZZZ",
    "sequence": 1245,
    "reason": "round_robin",
    "request_id": "req_abc123",
    "idempotency_key": "c1f2-..."
  },
  {
    "timestamp": "2025-09-18T16:15:00Z",
    "object": "Lead",
    "object_id": "00Qxx0000Lm78AA",
    "action": "enrich",
    "reason": "auto_enrichment",
    "request_id": "req_def456",
    "idempotency_key": "a3b4-...",
    "diff": { … }
  }
]