はじめに
認証
すべてのリクエストは Authorization ヘッダーに Bearer トークンを載せます。API キーはひとつのワークスペースに属します。オーナーまたは管理者がそのワークスペース内の「接続」で作成し、pc_ で始まり、一度だけ表示され、そのワークスペースにだけ管理者権限でアクセスします。クライアント側のコードには置かないでください。失効は即座に反映され、作成者が管理者の役割を失った場合も同様です。
MCP コネクタのフローで得た OAuth アクセストークンも同じヘッダーで使えます。接続時にその人が選んだワークスペースに結び付けられ、その人自身の権限で動作します。いずれにせよ、ひとつの資格情報はちょうどひとつのワークスペースを開き、以下のすべてはその範囲に限られます。
最初のリクエスト
curl https://usepaperclerk.com/api/v1/templates \
-H "Authorization: Bearer pc_YOUR_TOKEN"