POST /api/v1/orgs/{orgId}/projects

URLパス内の組織内に新しいプロジェクトを作成します。エージェント エンジンを使用する組織では、 ORM_ADMIN または SYSTEM_ADMIN が必要であり、 エージェント エンジンプロジェクトを挿入します 。 Atlas ベースの組織では、呼び出し元の委任された Atlas 権限(その組織の OG_ADMIN、Atlas ORM_OWNER、または ORM_GROUP_CREATOR)を使用して Atlas でプロジェクトを作成し、 エージェント エンジンのプロジェクトレコードを返します。 Atlas 組織の下にあるエージェント エンジンに所有される子は作成されません。

path パラメータ

  • orgId string 必須

    組織ID

application/ JSON

body 必須

作成するプロジェクト

  • allow_member_invites ブール値
  • 説明 string
  • name string 必須

    名前は検証前に削除されます。 1-64 文字で、Unicode 文字または数字、スペース、および文字 - _ を含めることができます。 ( ) 、 、 @ + '.

    最小長は 1、最大長は 64 です。

  • 共有_ポリシー オブジェクト
    共有_ポリシー属性を非表示にする Shared_ policies 属性の表示 オブジェクト
    • allow_sources array[string]
    • 共有_モード array[string]
    • 共有可能な ブール値

応答

  • サポートされていない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ステータス理由フレーズ。

  • 201

    作成済み

    応答属性の非表示 応答属性の表示 オブジェクト
    • allow_member_invites ブール値
    • atlas オブジェクト
      Atlas 属性の非表示 Atlas 属性の表示 オブジェクト
      • environment string 必須
      • id string 必須
      • organization_id string 必須
    • can_manage_deployments ブール値
    • created_at string
    • 説明 string
    • id string
    • name string
    • org_id string
    • 共有_ポリシー オブジェクト
      共有_ポリシー属性を非表示にする Shared_ policies 属性の表示 オブジェクト
      • allow_sources array[string]
      • 共有_モード array[string]
      • 共有可能な ブール値
    • ソース string

      値は atlas または agent_engine です。

    • Updated_at string
    • Workspace_count integer

      WorkspaceCount は、プロジェクト内の削除されていないワークスペースの数です。リスト応答には含まれ、単一プロジェクト GET では省略されます。

    応答属性の非表示 応答属性の表示 オブジェクト
    • allow_member_invites ブール値
    • atlas オブジェクト
      Atlas 属性の非表示 Atlas 属性の表示 オブジェクト
      • environment string 必須
      • id string 必須
      • organization_id string 必須
    • can_manage_deployments ブール値
    • created_at string
    • 説明 string
    • id string
    • name string
    • org_id string
    • 共有_ポリシー オブジェクト
      共有_ポリシー属性を非表示にする Shared_ policies 属性の表示 オブジェクト
      • allow_sources array[string]
      • 共有_モード array[string]
      • 共有可能な ブール値
    • ソース string

      値は atlas または agent_engine です。

    • Updated_at string
    • Workspace_count integer

      WorkspaceCount は、プロジェクト内の削除されていないワークスペースの数です。リスト応答には含まれ、単一プロジェクト GET では省略されます。

  • 無効なリクエスト

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
  • 許可されていない

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

    Atlas_PAYMENT_METHOD_REQUERED

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

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

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

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

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
  • バード ゲートウェイ

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
  • サービスは利用できません

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
POST /api/v1 /orgs/{orgId}/projects
curl \
 --request POST 'https://agentengine.mongodb.com/api/v1/orgs/{orgId}/projects' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{
  "allow_member_invites": true,
  "description": "string",
  "name": "string",
  "sharing_policy": {
    "allowed_sources": [
      "string"
    ],
    "share_modes": [
      "string"
    ],
    "shareable": true
  }
}'
リクエスト例
{
  "allow_member_invites": true,
  "description": "string",
  "name": "string",
  "sharing_policy": {
    "allowed_sources": [
      "string"
    ],
    "share_modes": [
      "string"
    ],
    "shareable": true
  }
}
応答の例(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"
}
応答の例(201)
{
  "allow_member_invites": true,
  "atlas": {
    "environment": "string",
    "id": "string",
    "organization_id": "string"
  },
  "can_manage_deployments": true,
  "created_at": "string",
  "description": "string",
  "id": "string",
  "name": "string",
  "org_id": "string",
  "sharing_policy": {
    "allowed_sources": [
      "string"
    ],
    "share_modes": [
      "string"
    ],
    "shareable": true
  },
  "source": "atlas",
  "updated_at": "string",
  "workspace_count": 42
}
応答の例(201)
{
  "allow_member_invites": true,
  "atlas": {
    "environment": "string",
    "id": "string",
    "organization_id": "string"
  },
  "can_manage_deployments": true,
  "created_at": "string",
  "description": "string",
  "id": "string",
  "name": "string",
  "org_id": "string",
  "sharing_policy": {
    "allowed_sources": [
      "string"
    ],
    "share_modes": [
      "string"
    ],
    "shareable": true
  },
  "source": "atlas",
  "updated_at": "string",
  "workspace_count": 42
}
応答の例(400)
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例(400)
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例(401)
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例(401)
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例(402)
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例(402)
{
  "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
}
応答の例(409)
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例(409)
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例(500)
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例(500)
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例(502)
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例(502)
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例(503)
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例(503)
{
  "code": "string",
  "error": "string",
  "success": true
}