プロジェクトサービスアカウントの一覧表示

GET /api/v1/projects/{id}/service-accounts

Bearer 認証

プロジェクト範囲のカスタマーサービスアカウントを一覧表示します。 PROJECT_OWNER、PROJECT_MEMBER、または AGENT_DELEOPER （読み取り専用）が必要です。所有する組織の ORM_ADMIN も渡します。

path パラメータ

id string 必須

プロジェクトID

クエリパラメータ

limit integer

ページサイズ（デフォルトは50、最大 200）
cursor string

前の応答の next_cursor からのキーセットカーソル

応答

406

application/ JSON

application/ JSON アプリケーション/vnd.agent- engine-2026-09-20-preview+json

サポートされていないAPIバージョンまたは不正な API バージョン、選択した公開契約で利用できない操作、または受け入れができない表現（サポートされていないメディアタイプのパラメーター、または除外された SSE を含む）。既存の認証、認可、およびレート制限の失敗が優先されます。
応答属性の非表示応答属性の表示オブジェクト
- validRequestDetail オブジェクト
  
  標準エラースキーマによって定義される任意の検証の詳細。 APIネゴシエートエラーでは、このフィールドは出力されません。
  
  validRequestDetail 属性を非表示にする validRequestDetail 属性の表示オブジェクト
  
  フィールド array[オブジェクト]
  
  検証に失敗したフィールド。
  
  フィールド属性を非表示にするフィールド属性の表示オブジェクト
  
  フィールドとその検証の失敗。
  
  説明 string 必須
  
  人間が判読できる検証の失敗。
  
  フィールド string 必須
  
  無効なリクエストフィールドの名前またはパス。
- 詳細 string 必須
  
  人間が判読できるエラーの詳細。
- エラー integer 必須
  
  HTTP status code.
- errorCode string 必須
  
  マシンが判読できるエラーコード。
- パラメーター array[string]
  
  エラーに関連付けられたリクエストパラメータ名。該当しない場合は省略します。
- 理由 string 必須
  
  HTTPステータス理由フレーズ。
応答属性の非表示応答属性の表示オブジェクト
- validRequestDetail オブジェクト
  
  標準エラースキーマによって定義される任意の検証の詳細。 APIネゴシエートエラーでは、このフィールドは出力されません。
  
  validRequestDetail 属性を非表示にする validRequestDetail 属性の表示オブジェクト
  
  フィールド array[オブジェクト]
  
  検証に失敗したフィールド。
  
  フィールド属性を非表示にするフィールド属性の表示オブジェクト
  
  フィールドとその検証の失敗。
  
  説明 string 必須
  
  人間が判読できる検証の失敗。
  
  フィールド string 必須
  
  無効なリクエストフィールドの名前またはパス。
- 詳細 string 必須
  
  人間が判読できるエラーの詳細。
- エラー integer 必須
  
  HTTP status code.
- errorCode string 必須
  
  マシンが判読できるエラーコード。
- パラメーター array[string]
  
  エラーに関連付けられたリクエストパラメータ名。該当しない場合は省略します。
- 理由 string 必須
  
  HTTPステータス理由フレーズ。
200

アプリケーション/vnd.agent- engine-2026-09-20-preview+json

アプリケーション/vnd.agent- engine-2026-09-20-preview+json application/ JSON

OK
応答属性の非表示応答属性の表示オブジェクト
- Caller_ip string
  
  CallerIP は、ゲートウェイが認識する管理者のIPです（Gin ClientIP / 信頼できるプロキシ）。不明な場合は省略します。ここにピリオドを使用すると、 IPアクセスリストUI はキャッシュされたリスト応答（Atlas スタイル、専用の Each APIなし）からそれを読み取ることができます。
- 次の_カーソル string
  
  NextCursor は、次のページのキーセットカーソルです。このページが最後の場合は空になります。 total は常にスコープ全体をカウントし、カーソルは無視されます。
- service_accounts array[オブジェクト]
  
  service_Accounts 属性を非表示にする service_Accounts 属性の表示オブジェクト
  
  Active_secret オブジェクト
  
  Active_secret 属性を非表示 Active_secret 属性の表示オブジェクト
  
  created_at string
  
  expires_at string
  
  last_used_at string
  
  masked_value string
  
  client_id string
  
  created_at string
  
  説明 string
  
  id string
  
  ip_access_list array[string]
  
  is_active ブール値
  
  is_system_managed ブール値
  
  name string
  
  org_id string
  
  所有者 string
  
  project_id string
  
  role_assignments array[オブジェクト]
  
  role_assignments 属性を非表示にする role_assignments 属性の表示オブジェクト
  
  org_id string
  
  project_id string
  
  ロール string
  
  タイプ string
  
  Updated_at string
- 合計 integer
応答属性の非表示応答属性の表示オブジェクト
- Caller_ip string
  
  CallerIP は、ゲートウェイが認識する管理者のIPです（Gin ClientIP / 信頼できるプロキシ）。不明な場合は省略します。ここにピリオドを使用すると、 IPアクセスリストUI はキャッシュされたリスト応答（Atlas スタイル、専用の Each APIなし）からそれを読み取ることができます。
- 次の_カーソル string
  
  NextCursor は、次のページのキーセットカーソルです。このページが最後の場合は空になります。 total は常にスコープ全体をカウントし、カーソルは無視されます。
- service_accounts array[オブジェクト]
  
  service_Accounts 属性を非表示にする service_Accounts 属性の表示オブジェクト
  
  Active_secret オブジェクト
  
  Active_secret 属性を非表示 Active_secret 属性の表示オブジェクト
  
  created_at string
  
  expires_at string
  
  last_used_at string
  
  masked_value string
  
  client_id string
  
  created_at string
  
  説明 string
  
  id string
  
  ip_access_list array[string]
  
  is_active ブール値
  
  is_system_managed ブール値
  
  name string
  
  org_id string
  
  所有者 string
  
  project_id string
  
  role_assignments array[オブジェクト]
  
  role_assignments 属性を非表示にする role_assignments 属性の表示オブジェクト
  
  org_id string
  
  project_id string
  
  ロール string
  
  タイプ string
  
  Updated_at string
- 合計 integer
400

application/ JSON

application/ JSON アプリケーション/vnd.agent- engine-2026-09-20-preview+json

無効なリクエスト
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
403

application/ JSON

application/ JSON アプリケーション/vnd.agent- engine-2026-09-20-preview+json

Forbidden
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
404

application/ JSON

application/ JSON アプリケーション/vnd.agent- engine-2026-09-20-preview+json

見つかりません
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
500

application/ JSON

application/ JSON アプリケーション/vnd.agent- engine-2026-09-20-preview+json

内部サーバーエラー
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値

/api/v1 /projects/{id}/service-accounts を取得する

curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/service-accounts' \
 --header "Authorization: $API_KEY"

応答の例（406）

{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

{
  "detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
  "error": 406,
  "errorCode": "UNACCEPTABLE_MEDIA_TYPE",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

{
  "detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
  "error": 406,
  "errorCode": "UNSUPPORTED_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

応答の例（406）

{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

応答の例（200）

{
  "caller_ip": "string",
  "next_cursor": "string",
  "service_accounts": [
    {
      "active_secret": {
        "created_at": "string",
        "expires_at": "string",
        "last_used_at": "string",
        "masked_value": "string"
      },
      "client_id": "string",
      "created_at": "string",
      "description": "string",
      "id": "string",
      "ip_access_list": [
        "string"
      ],
      "is_active": true,
      "is_system_managed": true,
      "name": "string",
      "org_id": "string",
      "owner": "string",
      "project_id": "string",
      "role_assignments": [
        {
          "org_id": "string",
          "project_id": "string",
          "role": "string"
        }
      ],
      "type": "string",
      "updated_at": "string"
    }
  ],
  "total": 42
}

応答の例（200）

{
  "caller_ip": "string",
  "next_cursor": "string",
  "service_accounts": [
    {
      "active_secret": {
        "created_at": "string",
        "expires_at": "string",
        "last_used_at": "string",
        "masked_value": "string"
      },
      "client_id": "string",
      "created_at": "string",
      "description": "string",
      "id": "string",
      "ip_access_list": [
        "string"
      ],
      "is_active": true,
      "is_system_managed": true,
      "name": "string",
      "org_id": "string",
      "owner": "string",
      "project_id": "string",
      "role_assignments": [
        {
          "org_id": "string",
          "project_id": "string",
          "role": "string"
        }
      ],
      "type": "string",
      "updated_at": "string"
    }
  ],
  "total": 42
}

応答の例（400）

{
  "code": "string",
  "error": "string",
  "success": true
}

応答の例（400）

{
  "code": "string",
  "error": "string",
  "success": true
}

応答の例（403）

{
  "code": "string",
  "error": "string",
  "success": true
}

応答の例（403）

{
  "code": "string",
  "error": "string",
  "success": true
}

応答の例（404）

{
  "code": "string",
  "error": "string",
  "success": true
}

応答の例（404）

{
  "code": "string",
  "error": "string",
  "success": true
}

応答の例（500）

{
  "code": "string",
  "error": "string",
  "success": true
}

応答の例（500）

{
  "code": "string",
  "error": "string",
  "success": true
}

プロジェクトサービス アカウントの一覧表示

path パラメータ

クエリ パラメータ

応答

プロジェクトサービスアカウントの一覧表示

クエリパラメータ