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

# POST /v1/{+parent}/actuations

`POST /v1/{+parent}/actuations`

Creates a new actuation for an existing Deployment.

## Path parameters

- `parent` string, required

## Query parameters

- `requestId` string

## Request body

- Actuation — The Actuation object represents the bootstrap state and output results of deployed infrastructure and software.
  - `state` 'STATE_UNSPECIFIED' | 'INFRA_CREATING' | 'SUCCEEDED' | 'FAILED' | 'POST_INFRA_CONFIGURING' | 'INFRA_DESTROYING' | 'TIMEOUT' — Output only. Actuation state.
  - `actuationOutput` ActuationOutput — Message for output of actuation.
    - `errorLogs` string — A link to the actuation Cloud Build log.
    - `terraformError` string — Output only. Error message returned from Terraform.
    - `ansibleFailedTask` string[] — Output only. Failed task name returned from Ansible.
    - `terraformTemplate` string — Reference to the Terraform template used.
    - `errorCode` 'ERROR_CODE_UNSPECIFIED' | 'TERRAFORM_FAILED' | 'PERMISSION_DENIED_IN_TERRAFORM' | 'QUOTA_EXCEED_IN_TERRAFORM' | 'ANSIBLE_FAILED' | 'CONSTRAINT_VIOLATION_IN_TERRAFORM' | 'RESOURCE_ALREADY_EXISTS_IN_TERRAFORM' | 'RESOURCE_UNAVAILABLE_IN_TERRAFORM' | 'PERMISSION_DENIED_IN_ANSIBLE' | 'INVALID_SECRET_IN_ANSIBLE' | 'TERRAFORM_DELETION_FAILED' | 'RESOURCE_IN_USE_IN_TERRAFORM_DELETION' | 'ANSIBLE_START_FAILED' — Output only. Code describing any errors that may have occurred. If not specified, there is no error in actuation.
    - `ansibleError` string — Output only. Error message returned from Ansible.
    - `cloudbuildId` string — Cloud Build instance UUID associated with this revision, without any suffix or prefix
    - `blueprintId` string — Reference to the Blueprint Controller deployment and revision resource.
    - `actuateLogs` string — A link to the Cloud Storage file that stores build logs.
    - `hasUserFacingErrorMsg` boolean — Output only. Whether the error message is user facing. If true, the error message will be shown in the UI.
  - `deploymentOutput` DeploymentOutput[] — Output only. Deployment output.
    - `name` string — Name of the resource.
    - `type` string — Type of the resource.
  - `startTime` string, google-datetime — Output only. Start time stamp.
  - `name` string — The name of the actuation resource. The format is projects/{project}/locations/{location}/deployments/{deployment}/actuations/{actuation}.
  - `endTime` string, google-datetime — Output only. End time stamp.

## Response `200`

Successful response

---

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