GET /api/v1/orgs/{orgId}/projects
Bearer auth

List projects visible to the authenticated user based on their role assignments, scoped to the organization in the URL path.

Path parameters

  • orgId string Required

    Organization ID

Responses

  • 406

    Unsupported or malformed API version, an operation unavailable in the selected published contract, or an unacceptable representation (including unsupported media-type parameters or excluded SSE). Existing authentication, authorization, and rate-limit failures take precedence.

    Hide response attributes Show response attributes object
    • badRequestDetail object

      Optional validation details defined by the standard error schema; API negotiation errors do not emit this field.

      Hide badRequestDetail attribute Show badRequestDetail attribute object
      • fields array[object]

        Fields with validation failures.

        Hide fields attributes Show fields attributes object

        A field and its validation failure.

        • description string Required

          Human-readable validation failure.

        • field string Required

          Name or path of the invalid request field.

    • detail string Required

      Human-readable error details.

    • error integer Required

      HTTP status code.

    • errorCode string Required

      Machine-readable error code.

    • parameters array[string]

      Request parameter names associated with the error; omitted when none apply.

    • reason string Required

      HTTP status reason phrase.

    Hide response attributes Show response attributes object
    • badRequestDetail object

      Optional validation details defined by the standard error schema; API negotiation errors do not emit this field.

      Hide badRequestDetail attribute Show badRequestDetail attribute object
      • fields array[object]

        Fields with validation failures.

        Hide fields attributes Show fields attributes object

        A field and its validation failure.

        • description string Required

          Human-readable validation failure.

        • field string Required

          Name or path of the invalid request field.

    • detail string Required

      Human-readable error details.

    • error integer Required

      HTTP status code.

    • errorCode string Required

      Machine-readable error code.

    • parameters array[string]

      Request parameter names associated with the error; omitted when none apply.

    • reason string Required

      HTTP status reason phrase.
  • 200

    OK

    Hide response attributes Show response attributes object
    • atlas_reauth_required boolean

      AtlasReauthRequired is set on this 200 response when the Atlas grant is unusable but the gateway still returns the last reflected projects as read-only. Clients should start recovery from this field; project list does not return 401 PLATFORM_OAUTH_*.

    • projects array[object]
      Hide projects attributes Show projects attributes object
      • allow_member_invites boolean
      • atlas object
        Hide atlas attributes Show atlas attributes object
        • environment string Required
        • id string Required
        • organization_id string Required
      • can_manage_deployments boolean
      • created_at string
      • description string
      • id string
      • name string
      • org_id string
      • sharing_policy object
        Hide sharing_policy attributes Show sharing_policy attributes object
        • allowed_sources array[string]
        • share_modes array[string]
        • shareable boolean
      • source string

        Values are atlas or agent_engine.

      • updated_at string
      • workspace_count integer

        WorkspaceCount is the number of non-deleted workspaces in the project. Included on list responses and omitted on single-project GET.

    • total integer
    Hide response attributes Show response attributes object
    • atlas_reauth_required boolean

      AtlasReauthRequired is set on this 200 response when the Atlas grant is unusable but the gateway still returns the last reflected projects as read-only. Clients should start recovery from this field; project list does not return 401 PLATFORM_OAUTH_*.

    • projects array[object]
      Hide projects attributes Show projects attributes object
      • allow_member_invites boolean
      • atlas object
        Hide atlas attributes Show atlas attributes object
        • environment string Required
        • id string Required
        • organization_id string Required
      • can_manage_deployments boolean
      • created_at string
      • description string
      • id string
      • name string
      • org_id string
      • sharing_policy object
        Hide sharing_policy attributes Show sharing_policy attributes object
        • allowed_sources array[string]
        • share_modes array[string]
        • shareable boolean
      • source string

        Values are atlas or agent_engine.

      • updated_at string
      • workspace_count integer

        WorkspaceCount is the number of non-deleted workspaces in the project. Included on list responses and omitted on single-project GET.

    • total integer
  • 400

    Bad Request

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
  • 403

    Forbidden

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
  • 500

    Internal Server Error

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
GET /api/v1/orgs/{orgId}/projects 
curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/orgs/{orgId}/projects' \
 --header "Authorization: $API_KEY"
Response examples (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"
}
Response examples (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"
}
Response examples (200) 
{
  "atlas_reauth_required": true,
  "projects": [
    {
      "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
    }
  ],
  "total": 42
}
Response examples (200) 
{
  "atlas_reauth_required": true,
  "projects": [
    {
      "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
    }
  ],
  "total": 42
}
Response examples (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (403) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (403) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}