パーソナルアクセストークンを作成する
パーソナルアクセストークン(edge_pat_…)を使うと、スクリプト、CI ジョブ、エージェントがブラウザでのサインインなしに、あなたとして Edge を呼び出せます。できることと期限はあなたが選び、いつでも取り消せます。
どのトークンにも次の 3 つのルールがあります。
- あなた以上の権限は持てません。 付けられるのは自分のロールが持つスコープだけです。
token.adminは付けられません。 - 1 つのワークスペースでだけ使えます。 作成したワークスペースです。別のワークスペースへのリクエストは 403 になります。
- 表示は一度だけです。 Edge はハッシュしか保存しません。なくした場合は取り消して、新しく作成してください。
権限と有効期限を選ぶ
用途に足りる、いちばん狭いものを選んでください。
| 権限 | スコープ | 用途 |
|---|---|---|
| 読み取りのみ | namespace.read, distribution.read, deployment.read, domain.read, analytics.read, logs.read | ダッシュボードやレポート |
| プレビューの公開 | distribution.read, deployment.read, deployment.write | プルリクエストのプレビュー。公開中のサイトは変えられません |
| 公開と promote | 上記に加えて deployment.promote | deployment を公開するリリースジョブ |
| カスタム | 自分が持つ任意のスコープ | それ以外 |
有効期限は 7 日、30 日(既定)、60 日、90 日、1 年、1 年以内の任意の日付、または 無期限 から選べます。無期限のトークンは取り消されるまで権限を持ち続けます。期限を付け、切れる前に入れ替えることをおすすめします。
コンソールで作成する
- サイドバーの Access tokens を開きます(
https://app.edge.deca-dev.com/edge/{workspaceId}/access-tokens)。 - Create token を選びます。
- Name に、使うものがわかる名前を入れます(例:
github-actions)。 - Permissions と Expiration を選びます。No expiration を選ぶと警告が表示されます。
- Review を選び、名前、ワークスペース、スコープ、有効期限を確認します。
- Create token を選び、トークンをコピーします。表示されるのはこの一度だけです。
トークンを作成しても、どのサイトも変わりません。
エージェント、CLI、または API で作成する
プレビューを公開できて 90 日で切れる、github-actions という名前の
パーソナルアクセストークンを作って。作る前にサマリーを見せて。edge tokens create# 1. サマリーを取得する。まだ何も作成されない。
curl -s -X POST https://api.edge.deca-dev.com/v1/tokens \
-H "Authorization: Bearer $EDGE_SIGN_IN_TOKEN" -H "Content-Type: application/json" \
-d '{"name":"github-actions","preset":"publish_previews","expiration":"90d"}'
# 2. 確認したら、同じ本文に "confirm": true を付けて送る。
curl -s -X POST https://api.edge.deca-dev.com/v1/tokens \
-H "Authorization: Bearer $EDGE_SIGN_IN_TOKEN" -H "Content-Type: application/json" \
-d '{"name":"github-actions","preset":"publish_previews","expiration":"90d","confirm":true}'1 回目の呼び出しは、確認するサマリーを返します。
{
"confirmation_required": true,
"summary": {
"name": "github-actions",
"namespace_id": "5c1e2a90-3f4b-4d6e-9a17-2b8c0d4e6f13",
"scopes": ["deployment.read", "deployment.write", "distribution.read"],
"expires_at": "2027-01-08T12:00:00Z"
}
}2 回目は、トークンを一度だけ返します。
{
"id": "01M4B2C9QW7RZJ5K8XYV3NTPDA",
"name": "github-actions",
"token": "edge_pat_3kT9vQ…",
"hint": "edge_pat_…7QxZ",
"status": "active",
"notice": "Copy the token now. Edge stores only its hash and cannot show it again."
}エージェントは edge_token_create を実行します。サマリーをあなたに見せて返事を待ってから、confirm を付けて再び呼び出す必要があります。パーソナルアクセストークンで別のトークンは作成できません。トークンはサインインしたセッションから作成してください。
スコープを個別に選ぶ場合は、preset の代わりに "scopes": ["deployment.read", "deployment.write"] を送ります。日付を指定する場合は、expiration の代わりに "expires_at": "2026-12-31" を送ります。無期限にする場合は "expiration": "never" を送ります。このときサマリーには warning が付きます。
使う
サインイン時のトークンと同じように、Bearer トークンとして送ります。
curl -s https://api.edge.deca-dev.com/v1/distributions \
-H "Authorization: Bearer edge_pat_3kT9vQ…"HTTP API と、Authorization ヘッダーを設定できるクライアントからの MCP サーバー(https://mcp.edge.deca-dev.com)で使えます。CLI と CI では EDGE_TOKEN として保存してください。GitHub Actions から公開する を参照してください。
一覧と取り消し
Access tokens ページに、自分のトークンのスコープ、有効期限、最終使用日時、状態が一覧されます。行の Revoke を選ぶとトークンはすぐに無効になり、それを使っているものは 401 を受け取るようになります。取り消しは元に戻せません。
Edge のアクセストークンを一覧して、old-ci という名前のものを取り消して。edge tokens ls
edge tokens revoke 01M4B2C9QW7RZJ5K8XYV3NTPDAcurl -s https://api.edge.deca-dev.com/v1/tokens -H "Authorization: Bearer $EDGE_SIGN_IN_TOKEN"
curl -s -X DELETE https://api.edge.deca-dev.com/v1/tokens/01M4B2C9QW7RZJ5K8XYV3NTPDA \
-H "Authorization: Bearer $EDGE_SIGN_IN_TOKEN"エージェントは edge_token_list と edge_token_revoke を実行します。一覧にトークンそのものは含まれず、edge_pat_…7QxZ のようなヒントだけが表示されます。
token.admin を持つ管理者は、組織内の全員のトークンを一覧し(GET /v1/tokens?all=true)、どれでも取り消せます。メンバーが離れたりロールが変わったりしたときに行ってください。トークンは、期限切れか取り消しまで、作成時のスコープを持ち続けます。