Kintone Record

API実行コマンド

1. 単一レコード取得

curl -s "https://{DOMAIN}/k/v1/record.json?app={APP_ID}&id={RECORD_ID}" \
  -H "{AUTH_HEADER}" | jq .

2. レコード一覧取得

curl -s "https://{DOMAIN}/k/v1/records.json?app={APP_ID}&query={QUERY}" \
  -H "{AUTH_HEADER}" | jq .

3. レコード作成

curl -s -X POST "https://{DOMAIN}/k/v1/record.json" \
  -H "{AUTH_HEADER}" \
  -H "Content-Type: application/json" \
  -d '{
    "app": {APP_ID},
    "record": {
      "フィールドコード": { "value": "値" }
    }
  }' | jq .

4. レコード更新

curl -s -X PUT "https://{DOMAIN}/k/v1/record.json" \
  -H "{AUTH_HEADER}" \
  -H "Content-Type: application/json" \
  -d '{
    "app": {APP_ID},
    "id": {RECORD_ID},
    "record": {
      "フィールドコード": { "value": "新しい値" }
    }
  }' | jq .

5. レコード削除

curl -s -X DELETE "https://{DOMAIN}/k/v1/records.json" \
  -H "{AUTH_HEADER}" \
  -H "Content-Type: application/json" \
  -d '{
    "app": {APP_ID},
    "ids": [{RECORD_ID}]
  }' | jq .

6. 複数レコード一括作成

curl -s -X POST "https://{DOMAIN}/k/v1/records.json" \
  -H "{AUTH_HEADER}" \
  -H "Content-Type: application/json" \
  -d '{
    "app": {APP_ID},
    "records": [
      { "フィールド1": { "value": "値1" } },
      { "フィールド2": { "value": "値2" } }
    ]
  }' | jq .

フィールド値のフォーマット

基本型

{
  "文字列フィールド": { "value": "テキスト" },
  "数値フィールド": { "value": "12345" },
  "日付フィールド": { "value": "2026-02-03" },
  "日時フィールド": { "value": "2026-02-03T10:00:00Z" }
}

選択系

{
  "ドロップダウン": { "value": "選択肢1" },
  "ラジオボタン": { "value": "選択肢A" },
  "チェックボックス": { "value": ["選択肢1", "選択肢2"] },
  "複数選択": { "value": ["A", "B", "C"] }
}

ユーザー選択

{
  "ユーザー選択": {
    "value": [
      { "code": "[email protected]" },
      { "code": "[email protected]" }
    ]
  }
}

テーブル（サブテーブル）

{
  "テーブル": {
    "value": [
      {
        "value": {
          "テーブル内フィールド1": { "value": "値1" },
          "テーブル内フィールド2": { "value": "値2" }
        }
      }
    ]
  }
}

使用例

例1: レコードを1件取得

/kintone-record get 123 1

例2: 条件に合うレコードを検索

/kintone-record list 123 status="完了" and 担当者 in ("田中")

例3: 新規レコード作成

/kintone-record create 123 会社名="テスト株式会社" 金額=10000

例4: レコード更新

/kintone-record update 123 1 status="完了"

エラーハンドリング

ユーザーの指示: $ARGUMENTS