#555
Personal access token v2 (PAT v2) のスコープについて
最終更新: 2025-09-08 11:42

スコープの定義

  • PAT v2のスコープは PERMISSION:RESOURCE の形式で定義されています
    • PERMISSION はHTTPメソッドに対応しています。
    • RESOURCE は操作対象のリソース名(単数形)に対応しています。

PERMISSION

PERMISSION HTTPメソッド 説明
read GET データの参照
write POST, PUT, PATCH データの作成・更新
delete DELETE データの削除

admin PERMISSION

admin 権限は read, write, deleteのすべてが許可されます。
例えば admin:postread:post write:post delete:post と同等の意味になります。

RESOURCE

RESOURCE 説明
attachment 記事やコメント上でアップロードされた添付ファイルです。
category 記事のカテゴリーです。
comment 記事に対するコメントです。
emoji チームにアップロードしたカスタム絵文字や絵文字のエイリアスです。
invitation チームへのメンバー招待です。
member チームとユーザーアカウントを紐づけるメンバー情報です。メンバーの権限にはownerまたは memberがあります。
post チームに投稿した記事です。
revision 記事の更新情報です。記事を更新するたびに、revisionが1つ作成されます。
sharing 記事の外部公開情報です。
star 記事やコメントに対するStar(スター)の情報です。
tag 記事のタグです。
team チーム自体の情報です。
user ユーザーアカウント自体の情報です。
watch 記事に対するWatch(ウォッチ)の情報です。
dev/esa/API/v1 #noexpand

Comments0