← Docs

API

SaykeeperのAPIを使うと、スクリプトやアシスタントが、打ち合わせを読み取れます。キーでできるのは、読み取りと質問だけです。作成、変更、削除はできません。

APIキー

キーは、アプリの「設定」の「APIとMCP」にある「APIキー」で作成します。名前を付けてください。
キーは1度だけ表示されます。SaykeeperはそのSHA-256ハッシュのみを保存するため、なくしたキーは再表示できません。そのキーを無効にして、新しく作成してください。
キーはntb_live_で始まります。URL、コードリポジトリ、共有チャットには入れないでください。

認証

キーは、AuthorizationヘッダーにBearerトークンとして送ります。どのリクエストでも、見られるのはキーの所有者の打ち合わせだけです。

Authorization: Bearer ntb_live_YOUR_KEY

ベースURL

https://api.saykeeper.com/v1

APIキーを受け付けるエンドポイント

メソッド	パス	返す内容
`GET`	`/meetings?limit=50`	ご自身の打ち合わせを新しい順に(最大200件、アーカイブ済みは?archived=true)。
`GET`	`/meetings/search?q=budget&limit=20`	タイトルと文字起こしの検索(フィルター：space_id、label_id、from、to)。
`GET`	`/meetings/{id}`	文字起こし(話者、時刻)とAIの出力つきの打ち合わせ1件。
`GET`	`/meetings/shared`	他の人があなたと共有した打ち合わせ。
`GET`	`/meetings/report`	レポート用に、話者つきで打ち合わせごとに1行。
`GET`	`/meetings/{id}/chat`	打ち合わせに保存された質問と回答。
`POST`	`/meetings/{id}/chat`	1つの打ち合わせへの質問。ボディは{"message":"..."}。
`GET`	`/meetings/{id}/clips`	打ち合わせから切り出したクリップ。
`GET`	`/labels`	ご自身のラベル。
`GET`	`/settings`	文字起こしとノートの言語を含む、ご自身の設定。
`POST`	`/mcp`	MCPサーバー(Streamable HTTP経由のJSON-RPC)。

録音、アップロード、打ち合わせの変更や削除、設定の変更、キーやウェブフックの管理には、ログイン済みのアプリが必要です。キーでこれらを行おうとすると、403 session_requiredが返ります。

例

検索

curl "https://api.saykeeper.com/v1/meetings/search?q=budget" \
  -H "Authorization: Bearer ntb_live_YOUR_KEY"

文字起こしとノートつきの打ち合わせ1件

curl "https://api.saykeeper.com/v1/meetings/MEETING_ID" \
  -H "Authorization: Bearer ntb_live_YOUR_KEY"

打ち合わせについての質問

curl -X POST "https://api.saykeeper.com/v1/meetings/MEETING_ID/chat" \
  -H "Authorization: Bearer ntb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"What did we agree on?"}'

エラー

`400`	入力が正しくありません。たとえば、対応していない言語コードです(`unsupported_language`)。
`401`	キーがない、または無効です(`missing_bearer_token`、`invalid_api_key`)。
`403`	ログイン済みのアプリが必要です(`session_required`)、またはご自身の打ち合わせではありません。
`404`	見つかりません。
`409`	打ち合わせにまだ文字起こしがありません(`no_transcript`)。
`429`	レート制限に達しました(`rate_limited`)。少し待ってから、もう一度お試しください。

レート制限

内容	上限
打ち合わせへの質問(POST /meetings/{id}/chat)	20 / 分
MCPのask_meetingとask_meetings	20 / 分

ウェブフック

Saykeeperは、打ち合わせの準備ができたときに、お客様のURLを呼び出せます。ウェブフックは、「設定」の「APIとMCP」で追加します。配信ごとに、ウェブフックのシークレットで署名されます。

API