# 共有リソース API

プロキシ、グループ、タグの共有リソース管理API。これらのリソースはブラウザプロファイルとクラウドフォンの両方で使用されます。ベースURL: `http://127.0.0.1:40000`

Version: 2026-09-05

## Servers

[object Object]
```
http://127.0.0.1:40000
```

## Security

## Download OpenAPI description

 - [共有リソース API](https://guide.morelogin.com/_bundle/@l10n/ja/API%20Reference/Shared%20Resources/shared-api.yaml)

## Proxies

 - [POST /api/proxyInfo/page](https://guide.morelogin.com/ja/api-reference/shared-resources/shared-api/proxies/queryproxyinfopageusingpost.md): チームのプロキシ設定をページ単位で一覧します。 - **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。 - **補足**：一般メンバー、およびクラウドプロキシとダイナミックプロキシについてはパスワードが返されません。ダイナミックプロキシはここに現れますが、管理は別の場所で行われ、プロキシ系エンドポイントから編集することはできません。
 - [POST /api/proxyInfo/add](https://guide.morelogin.com/ja/api-reference/shared-resources/shared-api/proxies/addusingpost.md): チーム内にプロキシ設定を作成します。 - **前提条件**：`proxyPort` は必須で 1〜65535 の範囲、`proxyProvider` は認識されるデバイスサービスである必要があります。 - **副作用**：プロキシレコードを挿入し、その ID を返します。そのままプロファイルへ紐付けできます。プロキシ事業者側へは何も送信されません。 - **完了シグナル**：同期的です。 - **
 - [POST /api/proxyInfo/update](https://guide.morelogin.com/ja/api-reference/shared-resources/shared-api/proxies/updateproxyusingpost.md): プロキシ設定を更新します。 - **前提条件**：プロキシがチーム内に存在すること。**ダイナミックプロキシはこのエンドポイントから更新できません。** デバイスサービスは認識される値である必要があります。 - **副作用**：これは部分更新ではなく全体上書きです — 省略したフィールドは現在の値を保持するのではなくデフォルト値に戻ります。まずプロキシを読み出し、完全な形で送り返してください。 -
 - [POST /api/proxyInfo/delete](https://guide.morelogin.com/ja/api-reference/shared-resources/shared-api/proxies/deleteproxyusingpost.md): 1 つ以上のプロキシ設定を削除します。 - **前提条件**：少なくとも 1 つの ID がチーム内で解決できること。解決できないものは黙って無視されます。**期限切れでないクラウドプラットフォームプロキシは削除できず**、専用のエラーで報告されます。 - **副作用**：自前のプロキシは削除され、踏み台サーバーとの紐付けも解除されます。期限切れのクラウドプラットフォームプロキシは、代わりに解放待
## Groups

 - [POST /api/envgroup/page](https://guide.morelogin.com/ja/api-reference/shared-resources/shared-api/groups/apienvgrouppagepost.md): プロファイルグループをページ単位で一覧します。 - **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。 - **補足**：チームがグループ単位でアクセスを認可している場合、グループの付与が一切ないメンバーにはエラーではなく空のページが返ります。
 - [POST /api/envgroup/edit](https://guide.morelogin.com/ja/api-reference/shared-resources/shared-api/groups/apienvgroupeditpost.md): プロファイルグループをリネームします。 - **前提条件**：グループがチーム内に存在し、呼び出し元がそれに対する権限を持ち、新しい名前が他のグループと衝突しないこと。一意性チェックは名前が実際に変わる場合にのみ実行されます。 - **副作用**：グループをリネームします。プロファイルはそのまま残ります — プロファイルはグループを ID で参照するため、他に更新すべきものはありません。 - **
 - [POST /api/envgroup/create](https://guide.morelogin.com/ja/api-reference/shared-resources/shared-api/groups/apienvgroupcreatepost.md): プロファイルグループを作成します。 - **前提条件**：名前は空でなく、100 文字以内で、チーム内の既存グループと重複しないこと。**1 チームあたり 1000 グループまでです。** - **副作用**：グループを作成します。チームがグループ単位でアクセスを認可しており、呼び出し元がオーナーでない場合、呼び出し元にも新しいグループへのアクセス権が付与されます。 - **完了シグナル**：同期
 - [POST /api/envgroup/delete](https://guide.morelogin.com/ja/api-reference/shared-resources/shared-api/groups/apienvgroupdeletepost.md): 1 つ以上のプロファイルグループを削除します。 - **前提条件**：少なくとも 1 つの ID がチーム内で解決でき、呼び出し元がそれに対する権限を持つこと。解決できない ID は黙って無視されます。 - **副作用**：グループとそのメンバーアクセス権を削除します。そこに属していたブラウザープロファイルとクラウドフォンは未グループになるため、宙に浮いたグループ参照は残りません。環境も削除するフ
## Tags

 - [GET /api/envtag/all](https://guide.morelogin.com/ja/api-reference/shared-resources/shared-api/tags/apienvtagallget.md): チーム内のすべてのプロファイルタグを返します。 - **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。 - **補足**：このエンドポイントは**ページングされず、タグにはサーバー側の上限もありません**。したがってレスポンスはチームが作成したタグ数に応じて大きくなります。クライアント側の設計で考慮してください。
 - [POST /api/envtag/create](https://guide.morelogin.com/ja/api-reference/shared-resources/shared-api/tags/apienvtagcreatepost.md): プロファイルタグを作成します。 - **前提条件**：名前は空でなく、100 文字以内で、チーム内の既存タグと重複しないこと。 - **副作用**：タグを作成し、その ID を返します。グループと異なり、タグには件数上限がありません。 - **リトライ**：名前の重複は既存タグの再利用ではなく拒否として扱われます。`/envtag/all` で確認してください。
 - [POST /api/envtag/edit](https://guide.morelogin.com/ja/api-reference/shared-resources/shared-api/tags/apienvtageditpost.md): プロファイルタグをリネームします。 - **前提条件**：タグがチーム内に存在し、新しい名前が他のタグと衝突しないこと。 - **副作用**：タグをリネームします。既存のタグの紐付けは影響を受けず、プロファイルには即座に新しい名前が表示されます。 - **完了シグナル**：同期的かつ冪等です。
 - [POST /api/envtag/delete](https://guide.morelogin.com/ja/api-reference/shared-resources/shared-api/tags/apienvtagdeletepost.md): 1 つ以上のプロファイルタグを削除します。 - **前提条件**：少なくとも 1 つの ID がチーム内で解決できること。解決できないものは黙って無視されます。 - **副作用**：タグを削除します。そのタグは付いていたすべてのプロファイルから消え、プロファイル自体は削除されません。このエンドポイントはプロファイルタグのみを管理します — クラウドストレージのファイルタグは別に管理されます。 -
## Webhooks

 - [POST /api/webhook/config](https://guide.morelogin.com/ja/api-reference/shared-resources/shared-api/webhooks/apiwebhookconfigpost.md): チームの Webhook 設定を作成または置き換えます。 - **前提条件**：`callbackUrl` は 1〜1024 文字の HTTPS URL で、ホスト名を持ち、ユーザー情報とフラグメントを含まず、ポートが正しい必要があります。解決先のすべてのアドレスが公開経路である必要があり、localhost、プライベート、リンクローカル、CGNAT、クラウドメタデータ、プロトコル予約、ドキュメン
