開発者向け TrekMail Drive API の概要

TrekMail Drive API を使用すると、信頼できるアプリケーションや AI エージェントは、ダッシュボードや Webmail に表示されるものと同じファイルストレージを操作できます。フォルダーの一覧表示、ファイルのアップロード、公開ダウンロードリンクの生成、ゴミ箱内の項目の復元、ストレージ使用量の監査、反復的なファイルワークフローの自動化に使用でき、エージェントにアカウント全体へのアクセスを与える必要はありません。

Drive の自動化は TrekMail REST API v1 の一部です。Bearer トークン、JSON 応答、エンドポイントが対応する場合の冪等性保護を使用し、AI エージェントと API → 監査ログに表示されるものと同じ監査証跡を残します。Drive の権限モデルには、同期デバイスのパスワード用に分かれたスコープを含む 11 個のスコープがあります。エンドポイントと MCP ツールのカタログは変化するため、返されたツール一覧と API 応答から、現在トークンで利用できる機能を確認してください。

自動化できること

一般的な Drive API のジョブは次のとおりです。

• 月次レポートを Account Drive にアップロードする。
• クライアント用フォルダーを作成してファイルを追加し、1 つのダウンロードリンクを共有する。
• エージェントに Mailbox Drive スペースを検索させ、変更点を要約させる。
• 古いファイルをアーカイブフォルダーに移動する。
• 誤ってクリーンアップした後にゴミ箱からファイルを復元する。
• ストレージがほぼ満杯であることをユーザーに警告する前に Drive アドオンの状態を読み取る。

API は意図的にファイル処理に焦点を当てています。請求ダッシュボードを置き換えるものではなく、支払いやサブスクリプションの変更機能も提供しません。

Account Drive と Mailbox Drive

Drive には 2 つのストレージ領域があります。Account Drive は会社の共有スペースです。通常、ブランド素材、契約書、オンボーディング資料、チームフォルダーはここに保存します。Mailbox Drive は Webmail 内のメールボックスに付属する個人用ストレージです。

API リクエストでは space パラメーターで対象を指定します。

account       # Account Drive
mailbox:42    # mailbox-personal Drive for mailbox ID 42
123           # internal Drive space ID, if your integration stores it

トークンは特定のメールボックスだけに制限できます。トークンがメールボックス 42 に制限されている場合、メールボックス 99 へのリクエストには、他のメールボックスの存在を漏らすことなく「見つかりません」形式の応答が返されます。

認証とベース URL

Authorization ヘッダーで操作用トークンを使用します。

Authorization: Bearer tm_live_your_token

Drive エンドポイントは次の URL 以下にあります。

https://trekmail.net/api/v1/drive

AI エージェントと API → トークンからトークンを作成します。ワークフローに必要な Drive スコープだけを選択してください。

11 個の Drive スコープ

アップロードと大きなファイル

アップロードでは 2 段階のパターンを使用します。まず API がクォータを予約し、アップロード手順を返します。次にクライアントがファイルのバイト列をアップロード URL へ送信します。最後に API がアップロードを完了として記録します。大きなファイルではマルチパートアップロードを使用でき、長い転送が期限切れになった場合は各パートの URL を更新できます。

ほとんどの AI エージェントでは、低レベルのアップロードエンドポイントを直接呼び出すよりも MCP の drive_file_upload ツールの方が簡単です。1 つのコマンドでファイルサイズの検出、アップロード、完了、失敗時の中止を処理します。

共有リンク

共有リンクは、個々のファイルに対する公開ダウンロード URL を作成します。ファイルがメールには大きすぎる場合や、アクセスを取り消せるようにする場合に便利です。可能な限り有効期限とダウンロード数の上限を設定してください。生のリンクトークンは作成時に一度しか返されないため、ワークフローで必要な場合は、返された URL をすぐに保存します。

削除と完全消去の安全性

通常の削除操作ではファイルとフォルダーをゴミ箱に移動します。項目は、復元されるか、完全に消去されるか、製品の保持ルールで削除されるまで復元できます。完全削除操作には消去スコープが必要で、別のトークンに分離する必要があります。

Drive アドオンの境界

エージェントは drive:addon:read を使用して Drive アドオンの状態、価格、解約プレビューを読み取れます。Drive アドオンの購入、容量変更、解約は REST や MCP の書き込みツールでは実行できません。ストレージの請求をユーザーが意識して管理できるよう、これらの操作はダッシュボード内に限定されています。