Kai Resolution Agent

Kai resolution agent session management and action execution

Start agent session

post

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.

Authorizations

sessionAuth

connect.sidstringRequired

Session-based authentication via HTTP-only cookie

Path parameters

idintegerRequired

Signal ID to create session for

Responses

201

Agent session created

application/json

401

Not authenticated

403

Permission denied or plan feature not available

404

Signal not found

500

Server error

post

/concierge/alerts/{id}/agent-session

HTTPcURLJavaScriptPython

POST /api/concierge/alerts/{id}/agent-session HTTP/1.1
Accept: */*

{
  "session": {
    "id": 1,
    "alertId": 1,
    "status": "started",
    "createdAt": "2026-03-18T07:05:50.380Z"
  }
}

Get agent session status

get

Returns the current status and details of an agent session. Requires view_agent_remediation permission.

Authorizations

sessionAuth

connect.sidstringRequired

Session-based authentication via HTTP-only cookie

Path parameters

idintegerRequired

Agent session ID

Responses

200

Agent session details

application/json

401

Not authenticated

403

Permission denied or access denied

404

Session not found

500

Server error

get

/concierge/agent-sessions/{id}

HTTPcURLJavaScriptPython

GET /api/concierge/agent-sessions/{id} HTTP/1.1
Accept: */*

{
  "id": 1,
  "alertId": 1,
  "status": "started",
  "createdAt": "2026-03-18T07:05:50.380Z",
  "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-03-18T07:05:50.380Z",
      "duration": 1
    }
  ],
  "error": "text",
  "updatedAt": "2026-03-18T07:05:50.380Z"
}

Generate action proposals

post

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.

Authorizations

sessionAuth

connect.sidstringRequired

Session-based authentication via HTTP-only cookie

Path parameters

idintegerRequired

Agent session ID

Responses

200

Actions proposed successfully

application/json

401

Not authenticated

403

Permission denied or access denied

404

Session not found

500

Server error

post

/concierge/agent-sessions/{id}/propose

HTTPcURLJavaScriptPython

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"
          }
        ]
      }
    ]
  }
}

Execute approved actions

post

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.

Authorizations

sessionAuth

connect.sidstringRequired

Session-based authentication via HTTP-only cookie

Path parameters

idintegerRequired

Agent session ID

Body

application/json

actionIdsstring[]Required

IDs of approved actions to execute

Example: ["action_1","action_2"]

Responses

200

Actions executed

application/json

400

actionIds array required

401

Not authenticated

403

Permission denied or access denied

404

Session not found

500

Server error

post

/concierge/agent-sessions/{id}/execute

HTTPcURLJavaScriptPython

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-03-18T07:05:50.380Z",
      "duration": 1
    }
  ],
  "session": {
    "id": 1,
    "alertId": 1,
    "status": "started",
    "createdAt": "2026-03-18T07:05:50.380Z",
    "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-03-18T07:05:50.380Z",
        "duration": 1
      }
    ],
    "error": "text",
    "updatedAt": "2026-03-18T07:05:50.380Z"
  }
}

Cancel agent session

post

Cancels an active agent session. Requires create_agent_remediation permission.

Authorizations

sessionAuth

connect.sidstringRequired

Session-based authentication via HTTP-only cookie

Path parameters

idintegerRequired

Agent session ID

Responses

200

Session cancelled successfully

application/json

messagestringOptional

401

Not authenticated

403

Permission denied or access denied

404

Session not found

500

Server error

post

/concierge/agent-sessions/{id}/cancel

HTTPcURLJavaScriptPython

POST /api/concierge/agent-sessions/{id}/cancel HTTP/1.1
Accept: */*

{
  "message": "text"
}