---
title: "목록 대화 가져오기"
method: GET
path: "/webapi/v2/conversations"
tags: ["Conversations"]
---

# 목록 대화 가져오기

`GET /webapi/v2/conversations`

대화 목록을 가져옵니다. 대화는 기본적으로 마지막 대화 시간 기준으로 내림차순으로 정렬됩니다.

## Query parameters

- `userIds` unknown[], nullable
  - unknown
- `llmAppId` string, nullable
- `categoryId` string, nullable
- `startedAt` number, nullable — 이 값 이전의 첫 번째 대화 시간을 검색하십시오.
- `endAt` number, nullable — Search for last chat time before this value
- `firstChatStartedAt` number, nullable — Search for first chat time after this value
- `firstChatEndAt` number, nullable — Search for first chat time before this value
- `searchTerm` string, nullable
- `cursor` string, nullable
- `variables` string[], nullable
- `pageSize` integer
- `activeOnly` boolean
- `backgroundRunning` boolean, nullable
- `order` 'LAST_CHAT_TIME_DESC' | 'LAST_CHAT_TIME_ASC' | 'FIRST_CHAT_TIME_DESC' | 'FIRST_CHAT_TIME_ASC'

## Headers

- `AGENT-EMAIL` string
- `USER-EMAIL` string
- `OWN-USER-ID` string

## Response `200`

알겠습니다

- ConversationsResponse
  - `conversations` Conversation[], required
    - `id` string, required — 대화의 고유 ID
    - `title` string, required — 대화의 제목
    - `user` User, required
      - `userId` string, required — 유저의 고유 ID
      - `firstName` string, required — 유저의 이름
      - `lastName` string, required — 유저의 성씨
    - `createdAt` number, required — 대화 생성 시간
    - `lastChatTime` number, nullable, required — 대화 마지막 대화 시간
    - `isEnd` boolean, required — 대화가 완료되었습니까 아니면 안 되었습니까?
    - `categories` string[], nullable, required — 대화 카테고리
    - `memo` string, nullable, required — 대화 메모
    - `chats` Chat[], required — 대화 정보
      - `id` string, required — 대화의 고유 ID
      - `type` string, nullable — Node type of the chat
      - `sender` string, required — 보내는 사람 유형
      - `message` string, required — 대화 메시지
      - `source` ChatInputSource — Chat input source information in response.
        - `knowledgeBaseIds` string[], nullable — List of knowledge base IDs
        - `folderIds` string[], nullable — List of folder IDs
        - `webSites` string[], nullable — List of web sites
        - `searchAllSharedDocument` boolean — Search all shared documents
        - `searchAllPersonalDocument` boolean — Search all personal documents
        - `includingHashtags` string[], nullable — Including hashtags
        - `excludingHashtags` string[], nullable — Excluding hashtags
        - `includingHashtagsOperator` string, nullable — Including hashtags operator
        - `excludingHashtagsOperator` string, nullable — Excluding hashtags operator
        - `sharedKnowledgeBases` KnowledgeBaseInfo[], nullable — Shared knowledge bases with details
          - `id` string, required — Unique ID of the knowledge base
          - `name` string, required — Name of the knowledge base
        - `sharedFolders` FolderInfo[], nullable — Shared folders with details
          - `id` string, required — Unique ID of the folder
          - `name` string, required — Name of the folder
        - `personalKnowledgeBases` KnowledgeBaseInfo[], nullable — Personal knowledge bases with details
          - `id` string, required — Unique ID of the knowledge base
          - `name` string, required — Name of the knowledge base
        - `personalFolders` FolderInfo[], nullable — Personal folders with details
          - `id` string, required — Unique ID of the folder
          - `name` string, required — Name of the folder
      - `timestamp` number, required — 대화 메시지 생성 시간의 타임스탬프
      - `completed` boolean, required — Whether the chat generation is completed
      - `citations` Citation[], nullable, required — 인용 정보
        - `clueId` string, required — 단서의 고유 ID
        - `source` string, nullable — 인용 출처
        - `title` string, nullable — 단서의 문서 제목
        - `url` string, nullable — 인용문의 URL
        - `text` string, nullable — 인용문 텍스트
      - `rating` boolean, nullable, required — 대화 평가
      - `agentRating` boolean, nullable, required — 대화의 에이전트 평가
    - `chatCount` integer, required — 총 대화 수
    - `llmApp` LLMApp, required
      - `id` string, required — LLM 앱의 고유 ID
      - `name` string, required — LLM 앱의 이름
      - `description` string, nullable — LLM 앱 설명
    - `variables` object, nullable, required — 변수
  - `cursor` string, nullable, required — 페이지 네비게이션을 위한 커서

## Other responses

- `400` — Invalid request parameters.
- `401` — Authentication failed. The API-KEY header is missing or invalid.
- `403` — Access denied. The project is inactive or the request IP is not allowed.
- `500` — Internal server error.

---

[API](https://skmtc.net/allganize/apis/alli-api-documentation.md) · [All operations](https://skmtc.net/allganize/apis/alli-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/allganize/alli-api-documentation/versions/c3e966e54dfc/schema)