テーブルデータの更新

このインターフェースを使用することでエージェントのデータテーブル内の特定のレコードの値を更新できます。

リクエストメソッド

POST

エンドポイント

https://api-${endpoint}.gptbots.ai/v1/database/update/record

認証

認証方法の説明についてはAPI Overviewをご参照ください。

リクエスト

リクエスト例

curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/database/update/record' \ -H 'Authorization: Bearer ${API Key}' \ -H 'Content-Type: application/json' \ -d '{ "table_id": "673af861ed69656ac0895b07", "record_id": "123456", "filter": { "id": "789" }, "updated_fields": { "name": "99990", "age": "30" } }'

                      
                      curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/database/update/record' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
  "table_id": "673af861ed69656ac0895b07",
  "record_id": "123456",
  "filter": {
    "id": "789"
  },
  "updated_fields": {
    "name": "99990",
    "age": "30"
  }
}'

このコードブロックをポップアップで表示

リクエストヘッダー

フィールド	タイプ	説明
Authorization	Bearer ${API Key}	認証には `Authorization: Bearer ${API Key}` を使用してください。トークンはAPIキーページから取得できます。
Content-Type	application/json	データ形式は `application/json` を指定してください。

リクエストボディ

フィールド	タイプ	必須	説明
table_id	String	必須	テーブルID
record_id	String	任意	レコードID またはフィルター条件のいずれかを指定（レコードIDの指定を推奨）
filter	Map	任意	ユーザー定義のフィルター条件（例：カスタムの一意な主キーなど）
updated_fields	List	必須	更新するデータのセット

レスポンス

レスポンス例

{ "code": 0, "message": "OK" }

                      
                      {
    "code": 0,
    "message": "OK"
}

このコードブロックをポップアップで表示

成功時のレスポンス

フィールド	タイプ	説明
code	Int	メッセージ種別コード
message	String	メッセージの説明
data	Object	レスポンスの内容。データテーブルの一意な識別子を含みます。

エラー時のレスポンス

フィールド	タイプ	説明
code	Int	エラーコード
message	String	エラーの詳細内容

エラーコード

コード	メッセージ
40000	パラメータエラー
50000	システム内部エラー
403106	テーブルが見つかりません
403131	データテーブルにアクセスする権限がありません