---
title: "POST /v1/{+parent}/apps:importApp"
method: POST
path: "/v1/{+parent}/apps:importApp"
tags: ["projects"]
---

# POST /v1/{+parent}/apps:importApp

`POST /v1/{+parent}/apps:importApp`

Imports the specified app.

## Path parameters

- `parent` string, required

## Request body

- ImportAppRequest — Request message for AgentService.ImportApp.
  - `appContent` string, byte — Raw bytes representing the compressed zip file with the app folder structure.
  - `appId` string — Optional. The ID to use for the imported app. * If not specified, a unique ID will be automatically assigned for the app. * Otherwise, the imported app will use this ID as the final component of its resource name. If an app with the same ID already exists at the specified location in the project, the content of the existing app will be replaced.
  - `importOptions` ImportAppRequestImportOptions — Configuration options for the app import process. These options control how the import behaves, particularly when conflicts arise with existing app data.
    - `conflictResolutionStrategy` 'CONFLICT_RESOLUTION_STRATEGY_UNSPECIFIED' | 'REPLACE' | 'OVERWRITE' — Optional. The strategy to use when resolving conflicts during import.
  - `ignoreAppLock` boolean — Optional. Flag for overriding the app lock during import. If set to true, the import process will ignore the app lock.
  - `gcsUri` string — The [Google Cloud Storage](https://cloud.google.com/storage/docs/) URI from which to import app. The format of this URI must be `gs:///`.
  - `displayName` string — Optional. The display name of the app to import. * If the app is created on import, and the display name is specified, the imported app will use this display name. If a conflict is detected with an existing app, a timestamp will be appended to the display name to make it unique. * If the app is a reimport, this field should not be set. Providing a display name during reimport will result in an INVALID_ARGUMENT error.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/ces.md) · [All operations](https://skmtc.net/google/apis/ces/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/ces/versions/429598666166/schema)