AIR LOG 外部公開API

アカウント情報 (残高・プラン)

認証中トークンの残高・プランを返す。 録音トリガ前の残高確認用。 **read**。

コインの明細

新しい順。 正 = 付与、 負 = 消費。 `meetingId` が付く行はその会議の分。 残高は `GET /account`。 **read**。

会議一覧

トークン所有ユーザーの会議を新しい順に返す。 **read** スコープ。

録音開始 (ボット参加)

会議URLを指定して録音を開始する。 カレンダーに一致予定があれば実会議名・時刻・出席者で保存し、既に録音予定/録音中の会議は二重にせず既存を返す。 **write** スコープ。 コインは録音開始時に消費 (ここでは非消費)。

会議詳細

文字起こし本文・要約・アクションアイテムを1回で返す。 他人の会議は 404。 **read**。 長い会議は `transcript=text` + `transcriptMaxChars` で本文を分けて読める (続きは `nextOffset` を `transcriptOffset` に渡す。 続きの回は `summary`・`actionItems`・`attendeeEmails` を返さない)。

会議タイトル変更

会議のタイトルを変更する。 要約パイプラインの停滞時計 (updatedAt) を進めない実装のため、 処理待ちの会議でも安全に改名できる。 他人の会議は 404。 **write**。

会議削除

会議と文字起こし・要約・録画(S3実体含む)を削除。 他人の会議は 404。 **write**。

録画の再生 URL (署名付き・1 時間)

取込済みなら Supabase の署名 URL、 まだなら Recall から直接。 無いときは `url: null` と理由 (NOT_SAVED=設定で保存OFF / EXPIRED=取込期限切れ / NO_BOT=ボットが入っていない / UNAVAILABLE=一時的)。 **read**。

話者名の付け替え

ラベル (`話者1` 等) 単位でまとめて書き換える。 同じラベルを担当者に持つアクションアイテムも追随する。 ⚠️ `話者不明` は「誰が話したか読み取れなかった」行で、 名前を付けると複数人の発言がその人の名前になる。 **write**。

止まっている議事録生成を続きから再開

PROCESSING で、 かつ一定時間動いていない会議だけ (稼働中は 409 — 横取りすると課金とレート枠が溶ける)。 部分要約は消さないので追加のコインは要らない。 **write**。 1 会議 1 回/分。

要約の再生成

完了 / 失敗した会議だけ。 既存の要約・アクションアイテムを消して最初から作り直す (SUMMARY のコインを消費)。 `instruction` は利用者の要約指示として保存され、 次回以降の自動生成にも効く (画面と同じ)。 完了は GET の status / Webhook で。 **write**。 1 会議 1 回/分。

止めた定例の自動参加を再開

毎回失敗する定例として止めた自動参加を、 次回以降について再開する。 また 3 回失敗すれば改めて止まる。 **write**。

録音停止

録音中/予約中の会議を停止する (ボットを退出/キャンセルし PROCESSING へ)。 未開始や停止不能な状態は副作用なしで現状を返す。 **write**。

議事録エクスポート

議事録を書き出す (md / html)。 **read** スコープだがコインを消費する (EXPORT)。 課金副作用があるため POST (GET にしない)。

文字起こしの取り込み (テキスト)

録れなかった会議をあとから埋める。 他ツール (Zoom / Meet / Teams の書き出し・tl;dv・Notta・VTT/SRT) の文字起こしを、 既存の会議へ差し込む (`meetingId`) か会議ごと新しく作る (`title` + `startTime`)。 録音コインは取らない。 既に文字起こしがある会議は `replace: true` を明示したときだけ置き換える (409)。 `generateSummary` で議事録も作る (SUMMARY コイン。 始まらなかった理由は `summarySkipped`)。 **write**。 利用者単位 20/分。

音声/動画の署名付きアップロード URL (取り込み 1/2)

ファイルは返ってきた `uploadUrl` へ **PUT** で直接上げる (本文 = ファイル)。 API の本文で受ける口は無い (Vercel の 4.5MB 上限)。 上げ終わったら `key` を `POST /meetings/import-audio` に渡す。 **write**。 1 時間に 20 件。

音声/動画からの取り込み (取り込み 2/2)

上げ終わった音源の文字起こしを始める。 完了は `GET /meetings/{meetingId}` の status か Webhook (`meeting.completed` / `meeting.failed`) で知る。 課金は文字起こしが成立してから 30 分ごと 1 コマ。 他人の鍵は同じ文言で断る。 **write**。 利用者単位 10/分。

名刺一覧

氏名/会社名/メールの部分一致で検索。 **read**。

名刺登録 (手入力)

名刺を手入力フィールドで登録する (画像OCRは内部UI専用)。 会社を自動解決し、 個人メール一致は既存の人へ束ね、 同姓同社は警告する。 **write**。

名刺詳細

全項目＋紐づく確定議事録。 他人の名刺は 404。 **read**。

名刺更新

名刺のフィールドを更新する (誤字訂正・異動反映)。 `null` でクリア。 会社リンクは companyName/email を含めた時だけ再解決する (役職だけ変更しても会社リンクを失わない)。 **write**。

名刺削除

名刺と画像実体(他カード非共有分)を削除。 他人の名刺は 404。 **write**。

CRM コンタクト一覧

コンタクトの作成 (手入力)

`intakeSource: MANUAL` で作る。 `companyName` があれば既存の会社に結びつける。 **write**。

CRM コンタクト詳細

CRM コンタクト更新

ステージ・次アクション・タグ等を更新。 ステージ変更は内部スレッド(SSOT)へ伝播。 次アクション設定は MANUAL 扱い。 **write**。

CRM コンタクト削除

コンタクトを削除する。 **会議に紐づく確定コンタクトは削除できない (400)** — 孤児化を防ぐため名前修正/統合へ誘導する。 未確認(自動起票)や会議紐づき無しの人は削除可。 削除でメンバー0になった会議スレッドも後始末する。 **write**。

アクションアイテム横断一覧

全会議のタスクを期限昇順で返す。 **read**。

アクションアイテム更新

完了マーク・期限・担当の変更。 自分の会議に属さないタスクは 404。 **write**。

議事録横断ナレッジ検索

質問を投げると過去の議事録を横断して出典付きで回答する。 **read** スコープだが AI クレジット (コイン) を消費する (BYO鍵設定時は0・該当会議なしは非課金)。 専用レート枠 20/分。 会話は保存され `conversationId` で続けられる。

「AIに聞く」の会話一覧

最終発言の新しい順。 カーソル送り (`nextCursor` を `cursor` に渡す)。 `q` は見出しと発言の中身の部分一致。 **read**。

会話の全発言

古い順。 新しい方から最大 200 件 (`truncated` が true なら頭が切れている)。 他人の会話は 404。 **read**。

会話の削除

発言ごと消す (議事録の中身を含みうるので、 消す手段は必ず残す)。 **write**。

提案資料の版一覧 (横断)

提案スライド (SALES) とシステム提案書 (SYSTEM) の**版**を新しい順に返す。 作り直しても古い版は消えないので 1 会議に複数行が並ぶ (現行版は `isLatest`)。 **`?kind=` は受けない** — 種別の受け取り口は 1 か所 (未指定=SALES) という内部規約があり、 それを一覧に当てるとシステム提案書が黙って消えるため。 各行の `kind` で見分ける。 **read**。

提案資料 1 版の詳細

一覧の項目に加えて、 紙面の目次 (`pages`) と、 **会議 × 種別で 1 つしかない保存先** (`designSheetForMeeting` / `driveFileForMeeting`) を返す。 設計書スプレッドシートと Google ドライブの PDF は版をまたいで使い回すため、 作り直した版では自身の `designSheet` / `driveFile` が null になる (相手に渡してある URL はこちらで取る)。 **read**。

設計書 (要件定義 → 打ち手の検討 → 基本設計 → 詳細設計) の Markdown

Claude を呼ばないのでコインは消費しない。 `scope` は見積の枠の集計 (今回の対象 / 対象外・指摘)。 枠や印を動かす・設計書を直すのは画面 (関所)。 **read**。

完成 PDF の署名付きダウンロードURL

16:9 PDF の署名URLを **JSON で** 返す (302 リダイレクトではない。 呼び出し側が有効期限を 知れるようにするため)。 URL は短命なので、 保存するのは `deckId` の方。 完成前・1 枚直しの最中は 409 (`DECK_PDF_NOT_READY`)。 コインは消費しない。 **read**。

画面イメージ (システム全体像イメージ) の成果物

最新の版 (画面ごとの署名付き URL・5 分) と、 全ての版の目録。 生成・中止・版の削除は画面前提。 コインは消費しない。 **read**。

トークスクリプト一覧

トークスクリプトの生成を始める

選んだ会議の文字起こしを**全部**読んで、 実際に使われた言い回しを根拠つきの台本にする。 ⚠️ コインを消費する (チャンク従量 + 節ごと。 先に `POST /talk-scripts/estimate` で見積もる)。 応答は受付まで (201)。 完成は `GET /talk-scripts/{talkScriptId}` で見る (数分〜)。 **write**。 5 分に 3 回。

作る前の見積り (無料)

総チャンク数・コインの目安・長さごとの所要時間 (分)・材料にできない会議 (`skipped`)。 Claude は呼ばない。 **read**。

トークスクリプトの詳細 (進捗・本文・逐語)

トークスクリプトの削除

取り消せない。 **write**。

台本の書き出し (md / html)

完成した台本を文書にする (JSON で返す。 議事録の export と同じ形)。 コインは消費しない。 完成前は 409。 **read**。

失敗した台本を続きからやり直す

払った材料・設計図・本文は消さない (最初から払い直さない)。 残りの抽出・本文のぶん**コインを消費する** (額は詳細の remainingEstimatedCoins)。 残高が次の段に足りなければ 402 (次の段と完走までの目安を文に含む)。 FAILED 以外は 409。 抽出が済んでいるのに材料ゼロなら 409。 **write**。

章の AI 書き直し (コイン消費)

注文 (500 字まで) で 1 章を書き直させる。 出力上限に当たったときは保存も課金もしない (409)。 **write**。 20 回/分。

章の手直し (無料)

見出しと本文だけ (逐語 `evidence` は触れない — 誰も言っていない殺し文句を実績にしない)。 本文から消えた引用の数を `droppedQuotes` で返す。 **write**。

横断検索 (題名・発話・要約)

会議一覧の `q` は題名の索引にしか当たらない。 「どこで何と言ったか」はこちら。 1 種類あたりの走査は 500 件で頭打ちし、 打ったら `truncated: true` を返す (黙って落とさない)。 **read**。

アプリ内通知の一覧

待機室の承認依頼・録音/要約の失敗・関所の確認待ちなど。 Webhook は会議の完了/失敗しか出さないので、 「人が動けば結果が変わる通知」はこちらで読む。 **read**。

通知を既読にする

`ids` を省略すると未読を全部。 他人の通知 ID は数えない。 **write**。

購読中Webhook一覧

secret は返さない。 **read**。

Webhook登録

https の公開URLのみ (内部/プライベート宛は拒否)。 secret はこのレスポンスで一度だけ返す。 **write**。

Webhook更新 (一時停止/再開・購読差替)

enabled で有効/無効、 events で購読イベント差し替え。 URL/secret は変更不可。 **write**。

Webhook削除

未配信の delivery も CASCADE で削除。 **write**。

Webhook 配信ログ

配信の成否・再試行状況を返す (デバッグ・監視用)。 自分の Webhook 以外は 404。 **read**。