メインコンテンツへスキップ
PUT
会話変数を更新

承認

Authorization
string
header
必須

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

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

パスパラメータ

conversation_id
string<uuid>
必須

変数が属する会話の ID です。会話 ID は 会話一覧を取得 から取得します。

variable_id
string<uuid>
必須

更新する変数の ID です。変数 ID は 会話変数の取得 から取得します。

ボディ

application/json

会話変数を更新するためのリクエストボディです。

value
any
必須

変数の新しい値。変数の期待される型と一致する必要があります。

user
string

エンドユーザーの識別子。アプリ側で定義し、アプリ内で一意にします。エンドユーザーの識別 を参照してください。

レスポンス

変数が正常に更新されました。

id
string<uuid>

Variable ID.

name
string

変数名です。

value_type
string

変数の値の型です。指定可能な値:stringnumberobjectsecretfilebooleanarray[any]array[string]array[number]array[object]array[file]array[boolean]

value
string

変数値(複雑な型の場合は JSON 文字列)。

description
string

変数の説明です。

created_at
integer<int64>

作成タイムスタンプ。

updated_at
integer<int64>

最終更新タイムスタンプ。