> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# ListProjectReleases

# Package: containersProjects

# Namespace: ContainersProjects

# Method link: https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/list-project-releases.md

## Permission Scopes:
Manage AppSmith Projects: SCOPE.CONTAINERS.PROJECTS

## Introduction

Retrieves the versions of a project's mobile app, newest first.

Returns the app's 12 newest versions. The live version and the project's current version
(`headReleaseId`, or the newest version when it's empty) are always included, even when they're
older. Available only for projects
whose `platform` is `HIMALAYA_MOBILE`, to the site's owner and its collaborators who can edit the
app.

---

## REST API

### Schema

```
 Method: listProjectReleases
 Description: Retrieves the versions of a project's mobile app, newest first.  Returns the app's 12 newest versions. The live version and the project's current version (`headReleaseId`, or the newest version when it's empty) are always included, even when they're older. Available only for projects whose `platform` is `HIMALAYA_MOBILE`, to the site's owner and its collaborators who can edit the app.
 URL: https://www.wixapis.com/containers/projects/v1/projects/{projectId}/releases
 Method: GET
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  projectId
 Method parameters: 
   param name: projectId | type:   none | required: true 
 Return type: ListProjectReleasesResponse
  - name: releases | type: array<ProjectRelease> | description: The app's versions, newest first.  | validation: maxItems 14
     - name: releaseId | type: string | description: Release GUID. For example, `rel-4f9c2a1b7d3e`.  | validation: maxLength 200
     - name: label | type: string | description: Label of the version, when it has one.  | validation: maxLength 500
     - name: createdDate | type: string | description: Date and time the version was saved. Not returned for an older live or current version that isn't among the 12 newest.  | read-only: true | validation: format date-time
     - name: live | type: boolean | description: Whether this is the live version, which every user of the app gets.  
     - name: head | type: boolean | description: Whether this is the project's current version, the one the app previews and the next edit starts from: `headReleaseId`, or the newest version when the project has none.  


```

### Examples

### List Project Releases
Retrieves the versions of a project's mobile app, newest first.

```curl
curl -X GET \
'https://www.wixapis.com/containers/projects/v1/projects/6b2e9d4a-1c7f-4a35-8e0b-5d3f7a9c2e18/releases' \
-H 'Authorization: <AUTH>'
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.containers.projects.listProjectReleases(projectId)
 Description: Retrieves the versions of a project's mobile app, newest first.  Returns the app's 12 newest versions. The live version and the project's current version (`headReleaseId`, or the newest version when it's empty) are always included, even when they're older. Available only for projects whose `platform` is `HIMALAYA_MOBILE`, to the site's owner and its collaborators who can edit the app.
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  projectId
 Method parameters: 
   param name: projectId | type: string | description: GUID of the project to list the versions of. | required: true | validation: format GUID
 Return type: PROMISE<ListProjectReleasesResponse>
  - name: releases | type: array<ProjectRelease> | description: The app's versions, newest first.  | validation: maxItems 14
     - name: releaseId | type: string | description: Release GUID. For example, `rel-4f9c2a1b7d3e`.  | validation: maxLength 200
     - name: label | type: string | description: Label of the version, when it has one.  | validation: maxLength 500
     - name: _createdDate | type: Date | description: Date and time the version was saved. Not returned for an older live or current version that isn't among the 12 newest.  | read-only: true 
     - name: live | type: boolean | description: Whether this is the live version, which every user of the app gets.  
     - name: head | type: boolean | description: Whether this is the project's current version, the one the app previews and the next edit starts from: `headReleaseId`, or the newest version when the project has none.  


```

### Examples

### List the versions of a project's app
Retrieves the app's versions, newest first, with the live and current versions marked.

```javascript
import { projects } from "@wix/containers";

async function listProjectReleases() {
  const response = await projects.listProjectReleases("6b2e9d4a-1c7f-4a35-8e0b-5d3f7a9c2e18");
}

/* Promise resolves to:
 * {
 *   "releases": [
 *     {
 *       "releaseId": "rel-7a2d9e4c1b6f",
 *       "label": "New menu colors",
 *       "_createdDate": "2026-11-09T11:20:05.000Z",
 *       "live": false,
 *       "head": true
 *     },
 *     {
 *       "releaseId": "rel-3c8f1a6e9d2b",
 *       "label": "First version",
 *       "_createdDate": "2026-11-09T09:51:30.000Z",
 *       "live": true,
 *       "head": false
 *     }
 *   ]
 * }
 */

```

### listProjectReleases (self-managed)
Self-managed SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md).

```javascript
import { createClient } from '@wix/sdk';
import { projects } from '@wix/containers';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { projects },
  // Include the auth strategy and host as relevant
});


async function listProjectReleases(projectId) {
  const response = await myWixClient.projects.listProjectReleases(projectId);
};
```

---