Kai Resolution Agent
Kai resolution agent session management and action execution
Initiates a new Kai resolution agent session for a signal. The agent will analyze the signal and prepare to propose resolution actions. Requires create_agent_remediation permission and agentAI plan feature.
Session-based authentication via HTTP-only cookie
Signal ID to create session for
Agent session created
Not authenticated
Permission denied or plan feature not available
Signal not found
Server error
POST /api/concierge/alerts/{id}/agent-session HTTP/1.1
Accept: */*
{
"session": {
"id": 1,
"alertId": 1,
"status": "started",
"createdAt": "2026-01-01T00:00:00.000Z"
}
}Returns the current status and details of an agent session. Requires view_agent_remediation permission.
Session-based authentication via HTTP-only cookie
Agent session ID
Agent session details
Unique session identifier
Associated signal ID
Current session status
Error message if session failed
Not authenticated
Permission denied or access denied
Session not found
Server error
GET /api/concierge/agent-sessions/{id} HTTP/1.1
Accept: */*
{
"id": 1,
"alertId": 1,
"status": "started",
"createdAt": "2026-01-01T00:00:00.000Z",
"analysis": {
"rootCause": "text",
"impact": "text",
"affectedSystems": [
"text"
],
"entityLifecycleContext": "text",
"isAnomalyPattern": true,
"patternDescription": "text",
"confidence": 1
},
"proposedActions": [
{
"id": "action_1",
"actionType": "reprocess_usage_batch",
"description": "text",
"isAutomated": true,
"targetSystem": "Stripe",
"targetEntities": [
"text"
],
"expectedOutcome": "text",
"risk": "low",
"steps": [
{
"order": 1,
"description": "text",
"apiCall": "text"
}
]
}
],
"executionResults": [
{
"actionId": "text",
"success": true,
"response": {},
"error": "text",
"executedAt": "2026-01-01T00:00:00.000Z",
"duration": 1
}
],
"error": "text",
"updatedAt": "2026-01-01T00:00:00.000Z"
}Triggers Kai to analyze the signal and generate proposed resolution actions. The agent performs root cause analysis and identifies systemic issues rather than isolated failures. Actions are categorized as automated (Kai can execute) or manual (requires user intervention). Requires create_agent_remediation permission and agentAI plan feature.
Session-based authentication via HTTP-only cookie
Agent session ID
Actions proposed successfully
Not authenticated
Permission denied or access denied
Session not found
Server error
POST /api/concierge/agent-sessions/{id}/propose HTTP/1.1
Accept: */*
{
"session": {
"id": 1,
"status": "awaiting_confirmation",
"alertId": 1,
"analysis": {
"rootCause": "text",
"impact": "text",
"affectedSystems": [
"text"
],
"entityLifecycleContext": "text",
"isAnomalyPattern": true,
"patternDescription": "text",
"confidence": 1
},
"proposedActions": [
{
"id": "action_1",
"actionType": "reprocess_usage_batch",
"description": "text",
"isAutomated": true,
"targetSystem": "Stripe",
"targetEntities": [
"text"
],
"expectedOutcome": "text",
"risk": "low",
"steps": [
{
"order": 1,
"description": "text",
"apiCall": "text"
}
]
}
]
}
}Executes the specified resolution actions that the user has approved. The agent will make API calls to the relevant billing/payment systems and report results. Requires execute_agent_remediation permission and agentAI plan feature.
Session-based authentication via HTTP-only cookie
Agent session ID
IDs of approved actions to execute
["action_1","action_2"]Actions executed
actionIds array required
Not authenticated
Permission denied or access denied
Session not found
Server error
POST /api/concierge/agent-sessions/{id}/execute HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 37
{
"actionIds": [
"action_1",
"action_2"
]
}{
"results": [
{
"actionId": "text",
"success": true,
"response": {},
"error": "text",
"executedAt": "2026-01-01T00:00:00.000Z",
"duration": 1
}
],
"session": {
"id": 1,
"alertId": 1,
"status": "started",
"createdAt": "2026-01-01T00:00:00.000Z",
"analysis": {
"rootCause": "text",
"impact": "text",
"affectedSystems": [
"text"
],
"entityLifecycleContext": "text",
"isAnomalyPattern": true,
"patternDescription": "text",
"confidence": 1
},
"proposedActions": [
{
"id": "action_1",
"actionType": "reprocess_usage_batch",
"description": "text",
"isAutomated": true,
"targetSystem": "Stripe",
"targetEntities": [
"text"
],
"expectedOutcome": "text",
"risk": "low",
"steps": [
{
"order": 1,
"description": "text",
"apiCall": "text"
}
]
}
],
"executionResults": [
{
"actionId": "text",
"success": true,
"response": {},
"error": "text",
"executedAt": "2026-01-01T00:00:00.000Z",
"duration": 1
}
],
"error": "text",
"updatedAt": "2026-01-01T00:00:00.000Z"
}
}Cancels an active agent session. Requires create_agent_remediation permission.
Session-based authentication via HTTP-only cookie
Agent session ID
Session cancelled successfully
Not authenticated
Permission denied or access denied
Session not found
Server error
POST /api/concierge/agent-sessions/{id}/cancel HTTP/1.1
Accept: */*
{
"message": "text"
}Last updated
Was this helpful?