REST API リファレンス

Page Lemon の REST API は https://api.pagelemon.com/v1 にあります。シェルを使えるコードエージェントは、1 つのコマンドでフォルダを公開できます。AI エージェントは、まずAI 向け公開ガイド（Markdown）から読み始めてください。

最終更新 2026年10月13日 · Markdown で見る

クイックスタート

アカウントなしでフォルダを公開します（保存しない限り、72 時間オンラインのままです）：

tar -czf - -C dist . | curl -sS --data-binary @- https://api.pagelemon.com/v1/deploy

API トークンがあれば、サイトはそのままアカウントに入ります：

tar -czf - -C dist . | curl -sS -H "Authorization: Bearer $PAGELEMON_TOKEN" --data-binary @- https://api.pagelemon.com/v1/deploy

ホスト

認証

認証情報は Authorization: Bearer <token> として送信します。

トークンはハッシュのみを保存しているため、紛失したトークンを再表示することはできません。新しく作成してください。

エラー

{ "error": { "code": "conflict", "message": "…" }, "agent_message": "…" }

agent_message は、AI からユーザーに伝えることがあるときに付いています。ユーザーの言語で伝え、リンク、コード、数字、日付、ドメインは正確なまま使ってください。時刻は UTC で、*_at のフィールドには ISO 形式で入っています。

デプロイ

POST /v1/deploy：アーカイブ 1 つ

リクエストボディがアーカイブそのものです：.tar.gz、.tgz、.tar、.zip。サーバーはバイト列から形式を判別するため、Content-Type は省略可能です。

tar -czf - -C <dir> . | curl -sS --data-binary @- https://api.pagelemon.com/v1/deploy

デプロイのたびにサイト全体が置き換わります。含めなかったファイルは公開中のサイトから削除されます。すべてのファイルが 1 つの最上位フォルダ（dist/index.html など）の下にある場合、そのフォルダは取り除かれます。

レスポンス 201：

{
  "site": { "name": "brave-otter-4821", "url": "https://brave-otter-4821.pagelemon.dev", "claimed": false, "expires_at": "2026-10-14T14:40:00Z" },
  "revision": { "id": "rev_…", "number": 1, "files": 12, "bytes": 48213 },
  "site_token": "st_…",
  "claim_url": "https://app.pagelemon.com/claim/ct_…",
  "skipped": [".env", "node_modules/…"],
  "agent_message": "Your site is live at …"
}

site_token と claim_url は匿名作成時のみ含まれます。

JSON による POST /v1/deploy：インラインファイル

MCP クライアントや小さなサイト向け：同じエンドポイントに Content-Type: application/json を送信します。

{ "site": "brave-otter-4821", "base_revision": "rev_…", "files": [ { "path": "index.html", "content": "<h1>Hi</h1>", "encoding": "utf8" } ] }

encoding は utf8 または base64 です。新しいサイトを作成するには site と base_revision を省略します。レスポンスは上記と同じです。

パッチ："patch": true を追加すると、base_revision に対して変更された files と "deleted": ["old.html"] だけを送信でき、それ以外はそのまま保持されます。上限とチェックは同じで、base_revision が古い場合は 409 conflict になります。

アップロードのルール

サイトごとの上限は、デプロイ後に公開されるサイト全体に対する値です。パッチでも、反映後のサイト全体で数えます。有料プランでは 1 つのサイトでプランのストレージをすべて使えますが、1 回のリクエストで送れるのは最大 90 MB（MCP 経由では 40 MB）です。それより大きいサイトは、最初のデプロイで送り、残りをパッチのデプロイで送ってください。上限を超えると、413 too_large と、表示用の agent_message が返ります。

• 拒否：シンボリックリンク、ハードリンク、デバイス、絶対パス、..、大文字・小文字だけが異なる重複パス。
• スキップされ skipped に記載：.git/、node_modules/、.env*、*.map、*.pem、*.key、.well-known/ 以外のドットファイル、.DS_Store、Thumbs.db。
• リーク防止：テキストファイルは、よく知られた種類の秘密鍵やプライベートキーが含まれていないかスキャンされます。検出されると {file, line, kind} 付きの 422 blocked_secret が返されます。キー自体が返されることはありません。
• 必須：ルートに index.html。
• 匿名のみ：実行ファイルとインストーラーはブロックされ、各ネットワークで作成できる匿名サイトとデプロイの数は少なく制限されます。それ以上はアカウントに保存するかログインしてください。

サイト

ロール：閲覧者はサイトとその履歴を読むことができます。編集者はさらにデプロイとロールバックができます。所有者はさらに招待、名前の変更、削除ができます。

アカウント

サイトの保存、招待の承認、トークン、請求は app.pagelemon.com で行います。

pagelemon.dev での配信

• / は index.html を配信します。/about は about.html または about/index.html を配信します。
• 存在しないファイルには、サイトの 404.html があればそれを、なければ当社のものを返します。
• シングルページアプリのフォールバック：サイトに 404.html がなく、パスにファイル拡張子がない場合、index.html が配信されます。
• ヘッダー：X-Content-Type-Options: nosniff、Referrer-Policy: strict-origin-when-cross-origin、HTML には Cache-Control: public, max-age=60、その他のファイルには max-age=300。Content-Type は許可リストに基づき、不明な形式は application/octet-stream として配信されます。
• 匿名のサイトと無料プランのサイトには、</body> の前に小さな「Page Lemon で公開中」バッジが付きます。スクリプトを使わない素の HTML と CSS で、サイトを報告するリンクも含まれます。
• 期限切れまたは削除されたサイトは 410 を返します。不正利用により停止されたサイトは 451 を返します。

.pagelemon.json

デプロイ後、エージェントはこのファイルをプロジェクトフォルダに書き込み、.gitignore に追加します。これにより、次のセッションで同じサイトを更新できます：

{ "site": "brave-otter-4821", "url": "https://brave-otter-4821.pagelemon.dev", "revision": "rev_…", "site_token": "st_…" }