REST API

数百〜数千ページのドキュメントを、ご自身のスクリプトから保存・削除します。AI は 関与しません。

PDF、表計算、レポートを 1 件ずつ手で入れる代わりに、一連の作業をスクリプトに任せます。 テキストの抽出と分割はご自身で行い、その結果だけを送ってください。

ここで保存したものは、接続した AI から保存したものとまったく同じです。同じ保存先に入り、AI の 呼び出し方も変わりません。

読み取り API はありません。 検索と取得は MCP と ダッシュボードが担当します。

はじめに

1. REST API のカードでキーを作成します — アカウントページに あります。キーの名前は、そのキーで保存したものすべての出所として記録されます。 Import script、pdf-importer のように、後から見てわかる名前にしてください。
2. キーは作成直後に一度だけ表示されます。その場でコピーしてください。再表示は できません。
3. キーはいくつでも作成でき、いつでも個別に削除できます。

認証

Authorization: Bearer api_xxxxxxxx

エンドポイント

curl -X POST https://contextick.ai/api/v1/notes \
  -H "Authorization: Bearer api_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"title":"Q3 report","summary":"Revenue and headcount for Q3.","content":"…"}'

{ "id": 42, "saved_items": 118, "stored_bytes": 1048576 }

curl -X DELETE https://contextick.ai/api/v1/notes/42 \
  -H "Authorization: Bearer api_xxxxxxxx"

curl -X POST https://contextick.ai/api/v1/notes/delete \
  -H "Authorization: Bearer api_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"ids":[42,43]}'

{ "deleted": [42], "not_found": [43], "saved_items": 117, "stored_bytes": 1040000 }

長いドキュメントはご自身で分割してください

本文の上限は 1 回の保存につき 16,000 文字です。こちらで分割はしません — 超えたものは content_too_long で拒否します。意味のまとまりで区切って 1 つずつ保存し、断片ごとに タイトルと要約を付けてください。ファイル名や見出しを知っているのはあなたなので、その方が後から ずっと呼び出しやすくなります。

エラー

失敗はすべて同じ形です:

{ "error": { "code": "quota_exceeded", "message": "…" } }

分岐は code で行ってください。message は人が読むための文章で、予告なく 変わることがあります。

知っておくこと

• 保存できる容量はプランによります — 料金をご覧ください。
• わかりにくい点や動かない点がありますか。お問い合わせください。すべての メッセージに担当者が目を通します。