---
title: "PATCH /v2/domains/{domainIdentifier}/projects/{identifier}"
method: PATCH
path: "/v2/domains/{domainIdentifier}/projects/{identifier}"
---

# PATCH /v2/domains/{domainIdentifier}/projects/{identifier}

`PATCH /v2/domains/{domainIdentifier}/projects/{identifier}`

Updates the specified project in Amazon DataZone.

## Path parameters

- `domainIdentifier` string, required
- `identifier` string, required

## Request body

- object
  - `name` string, password — The name to be updated as part of the <code>UpdateProject</code> action.
  - `description` string, password — The description to be updated as part of the <code>UpdateProject</code> action.
  - `resourceTags` object — The resource tags of the project.
  - `glossaryTerms` GlossaryTermId[] — The glossary terms to be updated as part of the <code>UpdateProject</code> action.
  - `domainUnitId` string — The ID of the domain unit.
  - `environmentDeploymentDetails` object — The environment deployment details.
    - `overallDeploymentStatus` 'PENDING_DEPLOYMENT' | 'IN_PROGRESS' | 'SUCCESSFUL' | 'FAILED_VALIDATION' | 'FAILED_DEPLOYMENT' — The overall deployment status of the environment.
    - `environmentFailureReasons` object — Environment failure reasons.
  - `userParameters` EnvironmentConfigurationUserParameter[] — The user parameters of the project.
    - `environmentId` string — The ID of the environment.
    - `environmentResolvedAccount` object — Specifies the account/Region that is to be used during project creation for a particular blueprint.
      - `awsAccountId` string, required — The ID of the resolved account.
      - `regionName` string, required — The name of the resolved Region.
      - `sourceAccountPoolId` string — The ID of the account pool.
    - `environmentConfigurationName` string, password — The environment configuration name.
    - `environmentParameters` EnvironmentParameter[] — The environment parameters.
      - `name` string — The name of an environment profile parameter.
      - `value` string — The value of an environment profile parameter.
  - `projectProfileVersion` string — The project profile version to which the project should be updated. You can only specify the following string for this parameter: <code>latest</code>.

## Response `200`

Success

- UpdateProjectOutput
  - `domainId` string, required — The identifier of the Amazon DataZone domain in which a project is updated.
  - `id` string, required — The identifier of the project that is to be updated.
  - `name` string, password, required — The name of the project that is to be updated.
  - `description` string, password — The description of the project that is to be updated.
  - `projectStatus` 'ACTIVE' | 'DELETING' | 'DELETE_FAILED' | 'UPDATING' | 'UPDATE_FAILED' | 'MOVING' — The status of the project.
  - `failureReasons` ProjectDeletionError[] — Specifies the error message that is returned if the operation cannot be successfully completed.
    - `code` string — The code of the project deletion error.
    - `message` string — The message of the project deletion error.
  - `createdBy` string, required — The Amazon DataZone user who created the project.
  - `createdAt` string, date-time — The timestamp of when the project was created.
  - `lastUpdatedAt` string, date-time — The timestamp of when the project was last updated.
  - `resourceTags` ResourceTag[] — The resource tags of the project.
    - `key` string, required — The key of the resource tag of the project.
    - `value` string, required — The value of the resource tag of the project.
    - `source` 'PROJECT' | 'PROJECT_PROFILE', required — The source of the resource tag of the project.
  - `glossaryTerms` GlossaryTermId[] — The glossary terms of the project that are to be updated.
  - `domainUnitId` string — The ID of the domain unit.
  - `projectProfileId` string — The ID of the project profile.
  - `userParameters` EnvironmentConfigurationUserParameter[] — The user parameters of the project.
    - `environmentId` string — The ID of the environment.
    - `environmentResolvedAccount` object — Specifies the account/Region that is to be used during project creation for a particular blueprint.
      - `awsAccountId` string, required — The ID of the resolved account.
      - `regionName` string, required — The name of the resolved Region.
      - `sourceAccountPoolId` string — The ID of the account pool.
    - `environmentConfigurationName` string, password — The environment configuration name.
    - `environmentParameters` EnvironmentParameter[] — The environment parameters.
      - `name` string — The name of an environment profile parameter.
      - `value` string — The value of an environment profile parameter.
  - `environmentDeploymentDetails` object — The environment deployment details of the project.
    - `overallDeploymentStatus` 'PENDING_DEPLOYMENT' | 'IN_PROGRESS' | 'SUCCESSFUL' | 'FAILED_VALIDATION' | 'FAILED_DEPLOYMENT' — The overall deployment status of the environment.
    - `environmentFailureReasons` object — Environment failure reasons.
  - `projectCategory` string — The category of the project.

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — AccessDeniedException
- `483` — ThrottlingException
- `484` — ServiceQuotaExceededException
- `485` — ConflictException
- `486` — ValidationException
- `487` — UnauthorizedException

---

[API](https://skmtc.net/aws/apis/datazone.md) · [All operations](https://skmtc.net/aws/apis/datazone/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/datazone/revisions/055599054b53/schema)