---
title: "POST /api/lists/agent"
method: POST
path: "/api/lists/agent"
tags: ["agent-list"]
---

# POST /api/lists/agent

`POST /api/lists/agent`

## Request

- Base URL: `https://app.heykairon.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.heykairon.com/api/lists/agent`
- Auth: API key in header `x-api-key`

## Request body

- AgentChatDto
  - `messages` unknown[], required
    - unknown
  - `model` string
  - `effort` 'minimal' | 'low' | 'medium' | 'high'
  - `searchMode` 'advanced' | 'my_network'
  - `listContext` object
    - `asset` 'leads' | 'companies', required
    - `listId` string, required
    - `diff` object, required
      - `added` object[], required
        - `key` string, required
        - `id` string
        - `hit` object, required
        - `qualification` unknown
      - `removedKeys` string[], required
  - `companyListMentions` object[]
    - `companyListId` string, required
    - `mode` 'include' | 'exclude', required

## Response `201`

---

[API](https://skmtc.dev/heykairon/apis/kairon-api.md) · [All operations](https://skmtc.dev/heykairon/apis/kairon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heykairon/apis/kairon-api/revisions/35de550d5938?raw)