Skip to main content
POST
会話の名前を変更

承認

Authorization
string
header
必須

すべてのリクエストは API キーで認証します:Authorization: Bearer {API_KEY}。アプリのエンドポイントにはアプリの API キーを、ナレッジのエンドポイントにはナレッジベースの API キーを使用します(Dify API クイックスタート)。

キーはサーバーサイドで保管し、クライアントコードには決して埋め込まないでください。キーが欠落または無効なリクエストは HTTP 401(unauthorized)で失敗します。

パスパラメータ

conversation_id
string<uuid>
必須

名前を変更する会話の ID です。会話 ID は 会話一覧を取得 で取得します。

ボディ

application/json
user
string
必須

エンドユーザーの識別子。アプリ側で定義し、アプリ内で一意にします。会話の作成時に使った user と一致する必要があります。エンドユーザーの識別 を参照してください。

Required string length: 1 - 255
name
string

新しい会話名です。auto_generate が true でない限り必須です。名前の保存は最大 255 バイトまでです。マルチバイト文字の長い名前は、文字の境界で切り詰めて保存され、エラーにはなりません。

Maximum string length: 255
auto_generate
boolean
デフォルト:false

会話の最初の質問から会話名を自動生成します。true の場合、name フィールドは無視されます。自動生成した名前も同じように切り詰められます。

レスポンス

更新後の会話です。名前は実際に保存された値が入ります。

id
string

会話 ID。

name
string

会話名です。

inputs
object

会話の作成時に送信された入力変数です。

status
string

常に normal です。

introduction
string

会話の作成時に記録されたアプリの開始文です。設定がない場合は空文字列になります。

created_at
integer

作成時刻(Unix タイムスタンプ、秒)です。

updated_at
integer

最終更新時刻(Unix タイムスタンプ、秒)です。