本文へ移動
Telemetry
ドキュメントを見る

APIリファレンス更新日: 2026年9月30日2 最小読み取り時間

コーディング エージェントでこのドキュメントを使用してください

Claude Code、Codex、Cursor、または別のコーディング エージェント用の集中プロンプト パックを開き、それをここで説明するワークフローに適応させます。

このページの内容
  1. 成功の応答
  2. 一致する行を削除する
  3. テーブル全体を削除する
  4. cURLでの使用例
  5. よくあるエラー

削除

これらの例では、予約済みのサンプルテーブル telemetry_quickstart に架空のデータを使います。API の動作を確認するもので、アプリの計測が完了したことを示すものではありません。アプリでは処理に合ったテーブルを選び、実際の操作からイベントを送信してください。

Delete API で条件に一致する行やテーブル全体を削除できます。削除は取り消せません。

削除 https://api.telemetry.sh/delete

ヘッダー

名前 タイプ 説明
コンテンツタイプ 文字列 アプリケーション/json
認可 文字列 API キー (生のキーまたは Bearer <key>

スコープのルール:

  • DELETE /delete には read-and-write が必要です

本体

名前 タイプ 説明
テーブル 文字列 データを削除したいテーブル
どこで 文字列 (オプション) 削除する行を指定する SQL 句

もし where が省略された場合、Telemetry はリクエストをテーブル全体の削除として扱います。

成功の応答

削除応答は、非同期のクリーンアップ確認応答です。 API が返されます 200 OK 削除リライトまたはテーブル無効化ステップが正常にスケジュールされるとすぐに。

一致する行を削除する

{
  "status": "success",
  "message": "Delete rewrite completed; part cleanup is asynchronous"
}

テーブル全体を削除する

{
  "status": "success",
  "message": "Table disabled; part cleanup is asynchronous"
}

cURLでの使用例

という名前のテーブルから 3 日より古いすべての行を削除するには telemetry_quickstart cURL を使用すると、次のコマンドを使用できます。

API_KEY="YOUR_API_KEY"
WHERE_CONDITION="timestamp <= (now() - INTERVAL '3 day')"

curl -X DELETE https://api.telemetry.sh/delete \
  -H "Content-Type: application/json" \
  -H "Authorization: $API_KEY" \
  -d @- <<EOF
{
  "table": "telemetry_quickstart",
  "where": "$WHERE_CONDITION"
}
EOF

全体を削除したい場合は、 telemetry_quickstart 表では、単純に省略します where フィールド:

API_KEY="YOUR_API_KEY"

curl -X DELETE https://api.telemetry.sh/delete \
  -H "Content-Type: application/json" \
  -H "Authorization: $API_KEY" \
  -d '{
    "table": "telemetry_quickstart"
  }'

重要な注意事項

  • データの削除: 削除エンドポイントを使用する場合は注意してください。もし where 条件が指定されていない場合は、テーブル全体が削除されます。
  • 不可逆性: データを削除すると、復元することはできません。
  • 従来のエンドポイント: 可能であれば、テーブル全体のライフサイクル操作にはテーブル API を優先します。 DELETE /delete を使用した行レベルの削除には引き続き便利です。 where 条項。

よくあるエラー

  • 400 Bad Request JSON ボディが無効な場合
  • 400 Bad Request 正規化後にテーブル名に無効な文字が含まれている場合
  • 403 Forbidden API キーに read-and-write スコープがない場合
  • 401 Unauthorized API キーが見つからないか無効な場合
  • 404 Not Found まだスキーマが存在しないテーブルから行を削除しようとした場合
  • 500 Internal Server Error Telemetry が削除リクエストの実行に失敗した場合

関連機能

安定したイベント名、型指定されたフィールド、プライバシーがレビューされたコンテキストをキャプチャします。

ページの著者と参考資料

Telemetry 編集チームがこの説明を所有しています。製品チームは動作、例、境界をレビューします。

ドキュメントのレビュー方法