List workspace deployment release versions

GET /api/v1/projects/{id}/workspaces/{workspace_id}/deployments/versions
Bearer auth

Proxies to ECP for one entry per release version: how many deployments that release shipped, when its code froze, and which deployment was the release event. A release is a boundary in the timeline, so a deployment belongs to the release that was open when it landed, or to the release whose artifact it deploys.

Path parameters

  • id string Required

    Project ID

  • workspace_id string Required

    Workspace 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 attribute Show response attribute object
    • versions array[object]
      Hide versions attributes Show versions attributes object
      • deployment_count integer
      • release_build_ids array[string]
      • release_deployment_id string

        ReleaseDeploymentID is empty when the release was built but never deployed; the UI then parents the group on the build_only row for one of ReleaseBuildIDs.

      • release_version string
      • released_at string(date-time)

        ReleasedAt is when this release was created (its cut). Membership of each deployment is shipped_in_release on the list row, not this timestamp.

    Hide response attribute Show response attribute object
    • versions array[object]
      Hide versions attributes Show versions attributes object
      • deployment_count integer
      • release_build_ids array[string]
      • release_deployment_id string

        ReleaseDeploymentID is empty when the release was built but never deployed; the UI then parents the group on the build_only row for one of ReleaseBuildIDs.

      • release_version string
      • released_at string(date-time)

        ReleasedAt is when this release was created (its cut). Membership of each deployment is shipped_in_release on the list row, not this timestamp.
  • 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
  • 502

    Bad Gateway

    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/projects/{id}/workspaces/{workspace_id}/deployments/versions 
curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/workspaces/{workspace_id}/deployments/versions' \
 --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) 
{
  "versions": [
    {
      "deployment_count": 42,
      "release_build_ids": [
        "string"
      ],
      "release_deployment_id": "string",
      "release_version": "string",
      "released_at": "2026-05-04T09:42:00Z"
    }
  ]
}
Response examples (200) 
{
  "versions": [
    {
      "deployment_count": 42,
      "release_build_ids": [
        "string"
      ],
      "release_deployment_id": "string",
      "release_version": "string",
      "released_at": "2026-05-04T09:42:00Z"
    }
  ]
}
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 (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}