GET /api/v1/organizations
Bearer 認証

呼び出し元がメンバーシップを持つ組織のみを返します。 Atlas の付与が使用できない場合でも、最後に反映された組織は、 atlas_reauth_required=true の読み取り専用として返されます。

応答

  • 406

    サポートされていない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

    OK

    応答属性の非表示 応答属性の表示 オブジェクト
    • atlas_reauth_required ブール値

      Atlas 付与が使用できず、かつゲートウェイが最後に反映された組織を読み取り専用として返す場合、この 200 応答に AtlasReauthRequired が設定されます。クライアントはこのフィールドからリカバリを開始する必要があります。組織リストから 401 PLATform_OAUTH_* が返されません。

    • limit integer

      制限 と オフセット は適用されたページ分割を確認します。ページ分割されたプラットフォーム管理リストによってのみ設定します。ノード向け組織のエンドポイントでは省略されます。

    • オフセット integer
    • 組織 array[オブジェクト]
      組織属性を非表示 組織属性の表示 オブジェクト
      • 管理者 array[オブジェクト]

        管理者は、組織の OG_ADMIN を一覧表示します。プラットフォーム管理者リストのみが入力されています。ノード向け組織のエンドポイントでは省略されます。

        管理属性を非表示にする 管理者属性の表示 オブジェクト
        • メールアドレス string
        • name string
      • atlas オブジェクト
        Atlas 属性の非表示 Atlas 属性の表示 オブジェクト
        • environment string 必須
        • id string 必須
      • created_at string
      • 説明 string
      • id string
      • name string
      • ソース string

        値は atlas または agent_engine です。

      • Updated_at string
    • 合計 integer
    応答属性の非表示 応答属性の表示 オブジェクト
    • atlas_reauth_required ブール値

      Atlas 付与が使用できず、かつゲートウェイが最後に反映された組織を読み取り専用として返す場合、この 200 応答に AtlasReauthRequired が設定されます。クライアントはこのフィールドからリカバリを開始する必要があります。組織リストから 401 PLATform_OAUTH_* が返されません。

    • limit integer

      制限 と オフセット は適用されたページ分割を確認します。ページ分割されたプラットフォーム管理リストによってのみ設定します。ノード向け組織のエンドポイントでは省略されます。

    • オフセット integer
    • 組織 array[オブジェクト]
      組織属性を非表示 組織属性の表示 オブジェクト
      • 管理者 array[オブジェクト]

        管理者は、組織の OG_ADMIN を一覧表示します。プラットフォーム管理者リストのみが入力されています。ノード向け組織のエンドポイントでは省略されます。

        管理属性を非表示にする 管理者属性の表示 オブジェクト
        • メールアドレス string
        • name string
      • atlas オブジェクト
        Atlas 属性の非表示 Atlas 属性の表示 オブジェクト
        • environment string 必須
        • id string 必須
      • created_at string
      • 説明 string
      • id string
      • name string
      • ソース string

        値は atlas または agent_engine です。

      • Updated_at string
    • 合計 integer
  • 500

    内部サーバーエラー

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
/api/v1 /organizations を取得する 
curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/organizations' \
 --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） 
{
  "atlas_reauth_required": true,
  "limit": 42,
  "offset": 42,
  "organizations": [
    {
      "admins": [
        {
          "email": "string",
          "name": "string"
        }
      ],
      "atlas": {
        "environment": "string",
        "id": "string"
      },
      "created_at": "string",
      "description": "string",
      "id": "string",
      "name": "string",
      "source": "atlas",
      "updated_at": "string"
    }
  ],
  "total": 42
}
応答の例（200） 
{
  "atlas_reauth_required": true,
  "limit": 42,
  "offset": 42,
  "organizations": [
    {
      "admins": [
        {
          "email": "string",
          "name": "string"
        }
      ],
      "atlas": {
        "environment": "string",
        "id": "string"
      },
      "created_at": "string",
      "description": "string",
      "id": "string",
      "name": "string",
      "source": "atlas",
      "updated_at": "string"
    }
  ],
  "total": 42
}
応答の例（500） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（500） 
{
  "code": "string",
  "error": "string",
  "success": true
}