コトロク取得 API(v1)

developer / 最終更新 2026年10月30日

会議で決まったタスクと予定を、スマホアプリや自作ツールから取り込むための API です。閲覧専用で、収録・削除・変更はできません。

認証

マイページの「アプリ連携(API トークン)」で発行した個人トークンを、Authorization ヘッダに付けます。

Authorization: Bearer kt_XXXXXXXX…

トークンは発行時に一度だけ表示されます。控え忘れたら失効させて発行し直してください
トークンで見えるのは、あなたが始めた会議と、参加者として名簿に入った会議のタスクだけです
失効はマイページから。失効後は 401 になります

エンドポイント

メソッド	パス	返すもの
GET	`/api/v1/me`	トークンの持ち主(メール・表示名)と、サーバー時刻
GET	`/api/v1/me/tasks?since=…&limit=…`	タスク。`since` 以降に作られた・変わったものだけ
GET	`/api/v1/me/events?since=…&limit=…`	予定(日時が特定できたイベント)。同上

since は ISO 8601(2026-10-25T00:00:00Z)か、ミリ秒の数値。省略すると全件。limit は最大 1000(既定 500)。結果は updatedAt の昇順で、応答の next を次回の since に入れると差分だけ取れます(since と同時刻のものは含めません)。

応答の例

GET /api/v1/me/tasks?since=2026-10-24T00:00:00Z

{
  "tasks": [
    {
      "id": "web-232f87a4:2026-10-24T09-46-44-047Z:t3",
      "title": "講師への連絡(持ち時間40分への変更ほか)を1通にまとめて送る",
      "assignee": "佐藤",
      "due": "10/29",
      "source": "佐藤: 木曜日までには連絡します",
      "status": "open",
      "roomId": "web-232f87a4",
      "roomName": "実測テスト(合成音声)",
      "sessionId": "2026-10-24T09-46-44-047Z",
      "minutesUrl": "https://kotoroku.com/g/web-232f87a4/",
      "createdAt": "2026-10-24T10:07:09.000Z",
      "updatedAt": "2026-10-24T10:07:09.000Z"
    }
  ],
  "count": 1,
  "since": "2026-10-24T00:00:00.000Z",
  "next": "2026-10-24T10:07:09.000Z",
  "serverTime": "2026-10-25T05:00:00.000Z"
}

イベントは title/assignee/due/source の代わりに name、startsAt(ISO 8601、+09:00)、description を持ちます。

項目の意味

項目	内容
`id`	一意 ID。`<会議室>:<回>:t<連番>`(予定は `e<連番>`)。会議の途中と確定版で同じタスクは同じ ID を保ちます。重複排除はこの ID で
`title`	タスクの内容(確定版は Sonnet が整えたもの)
`assignee`	担当者の表示名。発言から特定できないときは空。「自分の分だけ取り込む」フィルタに使えます
`due`	期日。会議で言われた形のまま(`10/29`、`金曜` など)。日付に解釈できないこともあります
`source`	根拠になった発言の引用(60 字以内)。詳細欄に入れると、あとで文脈が分かります
`status`	いまは常に `open`。マイページでの完了チェックを足したら `done` が増えます
`minutesUrl`	議事録のページ。会議が「参加者のみ」のときはコトロクへのログインが要ります
`updatedAt`	内容(題名・担当・期日・引用)が最後に変わった時刻。変わっていなければ進みません

取り込みの推奨

アプリを開いたとき、または 3 時間おきに GET /api/v1/me/tasks?since=<前回の next> を叩く
id が未知なら追加、既知で内容が変わっていれば未完了のものだけ更新
assignee が自分の名前と一致するものだけ取り込む、という絞り込みは任意
401 が返ったらトークンが失効しているので、再発行を促す

レート制限は今は設けていませんが、1 分に 1 回より速く叩く理由はありません。

変更の予定

status: done(マイページでの完了チェック)
.ics 形式の予定フィード(/api/v1/me/calendar.ics)
会議終了時の Webhook(プッシュ通知を受けられるアプリ向け)

質問は info@kotoroku.com へ。

コトロク 取得 API(v1)