> 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`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Introduction

## Article: Introduction

## Article Link: https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/introduction.md

## Article Content:

# About the Containers Projects API

The Containers Projects API lets you work with the projects of the Wix AI coding agent. A project is a mobile app that a user builds by chatting with the coding agent. Use this API to retrieve projects, resume work on them, save design changes, and restore earlier versions.

With the Containers Projects API, you can:

- Retrieve a project and its current status.
- Resume work on a project, so the coding agent can continue to build it.
- Save design changes as a new draft release, and preview them.
- Restore an earlier version of a project.

To chat with the coding agent about a project, use the [Containers Chat API](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-chat/introduction.md).

## The project lifecycle

A project's `status` changes in one direction only:

1. `PLANNING`: The user and the coding agent plan the app. New projects start with this status.
1. `PLAN_READY`: The plan is finalized, and the first build of the app is about to start.
1. `BUILDING`: The coding agent builds the app. The project stays in this status, and the user can continue to request changes.

You can resume a project only when its status is `BUILDING`.

## Releases and versions

Each design save and each edit by the coding agent creates a new draft release of the project's app. The project's `headReleaseId` is the release that the project is currently on. Your app previews this release, and the next design save or edit branches from it.

- [Save Project Design](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/save-project-design.md) creates a draft release from the release that the user is viewing, and sets `headReleaseId` to the new release.
- [Restore Release](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/restore-release.md) sets `headReleaseId` to an earlier release.

Neither method changes the project's live app.

When you specify a `conversationId`, both methods add a `CHECKPOINT` message to that conversation, so the user sees the saved or restored version in the chat.

## Platforms

Most new projects have `platform` set to `HIMALAYA_MOBILE`. For these projects, call [Get Himalaya Authorization](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/get-himalaya-authorization.md) to check that the current user can work on the project. The response also includes the canonical slug of the project's app in `canonicalApp`, which [Save Project Design](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/save-project-design.md) requires for these projects.

Older projects have `platform` set to `IOS` or `ANDROID`.

## Before you begin

It's important to note the following points before starting to code:

- The methods described in this API reference are in Beta.
- Projects belong to the Wix site they're created on.
- [Save Project Design](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/save-project-design.md) requires a short-lived control credential for the project's app releases, in `himalayaControlToken`.
- Only a project's owner can restore a release.
- [Resume Project](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/resume-project.md) starts the project's remote development environment in the background. The API doesn't report when the environment is ready.

## Use cases

- [Save a design change and preview it](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/sample-flows.md#save-a-design-change-and-preview-it)
- [Restore an earlier version of a project](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/sample-flows.md#restore-an-earlier-version-of-a-project)
- [Resume work on a project](https://dev.wix.com/docs/api-reference/mobile/containers-app/containers-projects/project-v1/sample-flows.md#resume-work-on-a-project)

## Terminology

- **Project**: An app that a user builds with the Wix AI coding agent.
- **Release**: A saved version of a project's app. Design saves and edits by the coding agent create draft releases.
- **Head release**: The release that a project is currently on, in `headReleaseId`.
- **Design-token document**: A JSON document that holds the design values of a project's app, such as its colors and fonts.
- **Remote development environment**: The environment in which the coding agent builds the project's app.
- **Checkpoint**: A message in a conversation that marks a saved or restored version of the project.

@sdk_package_setup