AI会話一覧取得

ログイン中のユーザーが所有するAI会話の一覧を取得します。応答は会話の更新日ごとにグループ化されて返され、ユーザーは自分が所有する会話のみ照会できます。

必要な権限

MEMBER以上のロールが必要です。

HTTPリクエスト

cURL例

curl -H "Authorization: Bearer <API_KEY>" \
     "https://HOSTNAME/api/sonar/ai/conversations?offset=0&limit=20"

リクエストパラメータ

正常応答

{
  "conversations": [
    [
      {
        "guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "owner_guid": "11111111-2222-3333-4444-555555555555",
        "owner_name": "alice",
        "title": "異常トラフィック調査",
        "is_custom_title": true,
        "llm_model": "gpt-4o",
        "created": "2024-09-15 14:30:00+0900",
        "updated": "2024-09-15 15:00:00+0900"
      }
    ]
  ]
}

• conversations (配列): 更新日ごとにグループ化された会話の一覧(更新日の降順)
  • (配列): 同じ日に更新された会話の一覧
    • guid (文字列): 会話のGUID
    • owner_guid (文字列): 会話の所有者のアカウントGUID
    • owner_name (文字列): 会話の所有者のアカウント名
    • title (文字列): 会話タイトル(ユーザーがタイトルを設定していない場合は既定値の 새 대화 または New conversation)
    • is_custom_title (ブーリアン): ユーザーがタイトルを設定したかどうか
    • llm_model (文字列): 会話で使用されたLLMモデルの識別子
    • created (文字列): 会話の作成時刻(yyyy-MM-dd HH:mm:ssZ 形式)
    • updated (文字列): 会話の更新時刻(yyyy-MM-dd HH:mm:ssZ 形式)

エラー応答

必須パラメータが欠落している場合

HTTPステータスコード 400 応答

{
  "error_code": "null-argument",
  "error_msg": "offset should be not null"
}

offset、limit値が整数でない場合

HTTPステータスコード 400 応答

{
  "error_code": "invalid-argument",
  "error_msg": "'offset' parameter should be int type"
}

権限がない場合

HTTPステータスコード 500 応答

{
  "error_code": "illegal-state",
  "error_msg": "no-permission"
}