The PersonaMonitorRuns REST API manages the execution instances of persona monitoring jobs. Track individual run results, performance metrics, and historical monitoring data.
Base URL: https://your-api-name.mercury.ratiomachina.com Authentication: x-mercury-api-key: YOUR_API_KEY
limit - Number of results (default: 50, max: 100)offset - Skip results for paginationjobId - Filter by monitor job IDpersonaId - Filter by persona IDstatus - Filter by run status (running, completed, failed, cancelled)startDate - Filter runs after dateendDate - Filter runs before date{
"runs": [
{
"id": "uuid-run-123",
"jobId": "uuid-job-456",
"personaId": "uuid-persona-789",
"personaName": "Sales Assistant Alex",
"status": "completed",
"startedAt": "2024-01-15T10:00:00Z",
"completedAt": "2024-01-15T10:30:00Z",
"duration": 1800000,
"results": {
"totalConversations": 45,
"successfulResponses": 43,
"failedResponses": 2,
"averageResponseTime": 1200,
"satisfactionScore": 4.2
},
"metrics": {
"cpuUsage": 0.25,
"memoryUsage": 0.15,
"apiCalls": 89,
"tokensUsed": 12450
},
"createdAt": "2024-01-15T10:00:00Z",
"updatedAt": "2024-01-15T10:30:00Z"
}
],
"pagination": {
"total": 142,
"limit": 50,
"offset": 0,
"hasNext": true,
"hasPrev": false
}
}{
"jobId": "uuid-job-456",
"personaId": "uuid-persona-789",
"configuration": {
"conversationLimit": 100,
"timeLimit": 3600,
"monitoringScope": "active_conversations",
"metricTypes": ["response_time", "satisfaction", "resolution_rate"],
"alertThresholds": {
"maxResponseTime": 30000,
"minSatisfactionScore": 3.0,
"maxFailureRate": 0.05
}
},
"scheduledAt": "2024-01-15T14:00:00Z"
}{
"run": {
"id": "uuid-run-890",
"jobId": "uuid-job-456",
"personaId": "uuid-persona-789",
"personaName": "Sales Assistant Alex",
"status": "scheduled",
"scheduledAt": "2024-01-15T14:00:00Z",
"configuration": {
"conversationLimit": 100,
"timeLimit": 3600,
"monitoringScope": "active_conversations"
},
"createdAt": "2024-01-15T13:45:00Z",
"updatedAt": "2024-01-15T13:45:00Z"
}
}id - Monitor run UUID{
"run": {
"id": "uuid-run-890",
"jobId": "uuid-job-456",
"personaId": "uuid-persona-789",
"personaName": "Sales Assistant Alex",
"status": "running",
"startedAt": "2024-01-15T14:00:00Z",
"progress": {
"conversationsProcessed": 23,
"totalConversations": 100,
"percentComplete": 23,
"estimatedCompletion": "2024-01-15T14:45:00Z"
},
"partialResults": {
"averageResponseTime": 1150,
"satisfactionScore": 4.1,
"successRate": 0.96
},
"createdAt": "2024-01-15T13:45:00Z",
"updatedAt": "2024-01-15T14:15:00Z"
}
}